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Introduction 

1.1 Overview 

The XENIX Operating System is a powerful multiuser, multitasking system of 
programs for your computer. It takes the place of your existing Operating System and 
givesyour computer the powCTofamuch larger and more expensivemachine. 

To do its work, the XENIX Operating System must be installed on your computer's 
hard disk. Thisallowsthe system totakecontrolof yourcomputerwheneveryouturnit 
on. The installation procedure consists of initializing your hard disk, then copying the 
XENIX system programs from the XENIX distribution floppydisks to the initialized 
hard disk. Note: "floppydisks" refers to the Sony Micro Floppydisks on which your 
system is distributed. 

1.2 XENIX Distribution Systems 

The complete XENIX System is a set of three distribution systems: 
The XENIX Operating System 

The XENIX Text Processing System 

The XENIX Development System 

TheOperatingSystem contains theXENIXprogramsyou need to createuser accounts, 
manage filesy stems and perform system maintenance tasks. 

The Text Processing System contains the XENIX programs used to create, edit, and 
typesetdocuments. 

The Development System contains the XENIX programs you need to create, compile, 
link.anddebugassemblyandhigh- level languageprograms. 

You install each package separately. Installation of the XENIX Operating System is 
required before you can install the Text Processing or Development Systems. The 
software for each System is write protected, except the Boot floppydisk of the 
OperatingSystem. 

1.3 What You Need 

Thisguideexpteimhow to instaUtheXENIX OperatingSystem. Todoso, you need: 

1. ALisacomputerwith at least 512k bytesof memory Itmusthavecither 

a)alOmegabyte internal hard disk 

harddisk 

2. TheXENIX Operating System distribution floppydisks 

If youhaveaLlSA2/10System, (which comes with an internal lOmegabytedisk), no 
other connections are necessary. 

If you have a LISA 2/5 System, (no internal hard disk), You must have at least one 
external 5 megabyte Profile disk. The first ProFile must be connected to the built— in 
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parallel port on the back of the Lisa computer. If you intend to install the XENIX Text 
Processing and/or the XENIX Development Systems, you will also need a second 
ProFile hard disk. This second disk must be connected to the upper parallel port of a 
parallel expansion board installed in expansion slot 1 ofthe Lisa computer. For details 
about these connections, see the hardware manualsprovided with your computer and 
the section called "Adding a Second ProFile Disk*' in Chapter 7 of the XENIX 
OperationsGuide. 

1.4 Before You Start 

Before you begin the installation procedure, make sure that your computer is fully 
assembled and that you are familiar with its operation. In particular, you diould know: 

How to turn the computer on and off. 

How to turn the ProFile hard disk on and off. 

How to insert a floppydisk into a disk drive. 

How to reset your computer with the RESET switch. 

If you have just assembled your computer for the first time, or if you are unsure about 
the four items listed above, take a few moments to review the hardware manuals 
provided withyourcomputerandharddisk. 

Duringthe installation, you will needtousethekeyboardtoenterinformation. Always 
type requested names and numbers exactly as shown. Begin each command at the 
beginning of a new line. Complete a line by pressing the RETURN key. Throughout 
misguide, theRETURNkeyisreferredtoas: 

RETURN 

If you make a typing error, you can delete the character you just typed by pressing the 
BACKSPACE key or by holding down the APPLE key and typing the letter "h". If you 
wish to delete everything you have typed on a line, hold down the APPLE key and type 
the letter "u". Many keys and key combinations have special meanings to the XENIX 
system. These keys and key combinations have special names that are unique to the 
XENIX system and may or may not correspond to the keytop labels on your keyboard. 
For more complete details about special XENIX keystrokes, see Chapter 1 in the 
XENlXOperarionsGuide. 
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Note 



If your keyboard does not have an APPLE key (a key with an apple on it), 
use the COMMAND key instead. 



1.5 Installation Procedure 

The installation procedure consists of six steps. You begin the installation by starting 
the XENIX system from the "boot" floppydisk. Next, run the hdinit program to 
initialize the hard disk and copy important XENIX programs to it. Then you start the 
system again (this time from die newly initialized hard disk) and run the firsttime 
program to copy the rest ofthe XENIX system program files to the hard disk. Finally, 
you create the super— user password and the first user account. 

The following seaionstellyouhowtoperformeach step. When you have finished the 
installation, keep this guide and the distribution floppydisks in a safe place. You will 
need themagainif you wish toreinstall the system for any reason. 

1.5.1 Starting XENIX From a Floppy Disk 

Starting the system is the first step of the installation procedure. To do this, you will 
need the distribution floppydisk labeled "Boot**. Once you have the floppydisk, 
follow these steps: 

1 . (For those with external hard disks only): Turn on the power to each hard 
disk. 

2. (For those with external hard disks only): Wait forthe "ready" light on the 
frontoftheharddiskdrive(s)toglowasteadyred. 

3. Turnonthepowertothecomputer. 

4. Wait for aclickdistenclosely — the click occurssoonafteryouturaonthe 
power). 

5. Hold down the APPLE key andpresstheENTERkey on the numeric key pad 
atmerightfrontcornerofthekeyboard. Thecomputerwillfirstdisplayaset 
of icons representing each phase of its self- test sequence, andthendisplay 
two numbered boxes. 

6. NowholddownmeAPPLEkeyandpressthenumberi. The computer will 
display amenu of icons representing each ofthe peripheral devicesattacbcd 
to the system. 

7. Insert the "Boot" distribution floppydisk into the floppy drive. Make sure 
thatthe label facesup and that you insert the side with the auto— shutter first. 
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8. HolddowntheAPPLEkeyandpr8ssthenumbcr2whichshouldcorrespond 
to the icon for the floppydisk. The computer reads the XENIX boot program 
fi^mthefioppydiskandbeginstoexecuteit. Thebootprogramdisplaysthe 
following pron^ 

boot 

Press thcRETURNkcy. 

9. The bootprogramreadsacopy ofthe XENIX Operating System kcmel&om 
the file fd(2,0)xemx and begins to execute it. To show that it is reading this 
file, the program displays the message: 

: fd(2,0)xenix 

Oncethe system begins to run, Hdisplayssomecopyright information, then 
the following message and boot floppy prompt: 

Lisa XENIX V3.0 Boot Floppy 
(backspace is "h, erase line is *u) 
Use "hdinit" to initialize hard disk. 
Use "upgrade" to upgrade 2.3 to 3.0 xenix 

1.5.2 Initializing tbe Hard Disk 

You must now initialize the hard disk with the hdinit (for "hard disk initialization") 
program. This program creates a "file system" on the hard disk, then copies system 
programs from the boot floppydisk to the new file system. If you have a second hard 
disk, the program also creates a file system on this disk and prepares it for receiving 
usa'sdirectoriesandfilesdurmgnormalXENIXoperation. 

Toinitializethediskordbks.followthesesteps: 

1. lnrcsponsetotheprompt: 

<BootRoppy> 

type: 

hdinit 

and press the RETURN key. The system reads the program from the boot 
floppydisk, beginstoexecutefranddisplaysthemessage: 

WARNING: 

This installation program will destroy 
the present contents of your hard disk- 
Do you want to continue <y/n>? 

If you haveany files on the harddiskthatyou wish to save, type: 
n 

and pressRETURN. The foliowingmessage appears: 
Aborting... 
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At this point the system shuts down automatically, and the following 
messageisdisplayed: 

*** Normal System Shutdown *** 

Reboot your existing system, and after you have backed up everything you 
wish to save, restart theXENIX installation procedure from thebeginning. 

To continue the installation, type: 

y 

andpresstheRETURNkey. Next, the message: 

Enter size of hard disk (5 or 10): 

will appear. If you are installing the system on a Lisa with one 5 megabyte 
hard disk, the correct response is "5**. ifyouareinstallingthesystemona 
Lisa 2/5, whichhasa5MBProFile attached to the parallel interface port, the 
response should be "5". ForaLisa2/10,withaninternallOMBharddisk, 
the appropriate response would be" 10**. 

The program creates the file system and begins to copy XENIX system files 
to it, reporting itsprogressas it goes. 

Making file system... 

After the file system is made, and the initial files copied to the hard disk, the 
fsck utility isrunto verify the contentsoftheharddisk and displays: 

/dev/root 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 — Check Reference Counts 

** Phase 5 - Check Free List 

XX files XXX blocks XXXX free 

The bootblockwillthenbecopiedtothe hard disk: 

Installing hard disk Boot. . . 

When the hdinit program is finished, it stops the system, preparing it forthe 
next installation step. Youwillseethemessage: 

Disk initialization is complete. 

** Normal System Shutdown ** 
You are now ready to start the system from the hard disk. 
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Note 



If you are installing XENIX on a USA 2/5, the bdinit 
program displays the message: 

drivename not on line 

when a profile disk is not connected to the proper parallel 
port or the disk's power is not on. drivename is the 
name of the disk drive (e.g. pfD or pf2). If you see 
the message, check the hard disk connections and make 
sure power is on, then press the RESET button and start 
the installation procedure from the beginning. 



1.5.3 Starting the System From the Hard Disk 

The third step in the installation procedure is to start the XENIX system by loading a 
copyofttfromthcharddiskintomemory. Follow these steps: 

1 . Press the On-Off button on the lower right front face of the Lisa once, to 
power downthe system. 

2. WaitStolCsecondsandpressthebuttonagain. 

3. TJiesystanwUln^displaytheself-testkans.auto—ioadtheXENIXboot 
programfnmitheharddiskthenprinttheprompt: 

boot: 



4. TotoadtheXENIXsystemthathasbcenloadedomothcharddisk.type: 

pf(0,0)xenix 

The computer reads a copy of the XENIX Operating System from the hard 
disk into memory. Once loaded, the system displays the copyright notice 
andthenthemessage: 

Entering System Maintenance Mode 

Lisa XENIX 3.0 Hard Disk initialization 
(backspace is *h, erase line is *u) 

The system immediately begins to execute the firsttime program, and you 
arereadytogoontothe next section. 
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1.5.4 Copying the XENIX System Files 

The firsttime program copies theXENIX program files from the remaining distribution 
floppydisks to the hard disk. It begins execution immediately after you start the system 
from the hard disk, so you do not have to type its name as you did for the bdinh 
program. 

1. Thehrsttimer^grambeginsbyn^askingifthercisasecondProRledisk 
attached to the system, so that the software may be most efficiently 
distributedonthetwodisks. The system will prompt: 

Do you want Aisr to be on a second profile <y/n>? 

2. lfyouareinstallingthesystemonaLJSA2/10,oronlyhaveoneprofikdisk, 
your response should be'V.andyou should go onto thenext step. 

Otherwise, the correct response is "y*'» «nd the system will display the 
message: 

Before making the Aisr filesystem, the second 
Profile must be connected to the upper parallel 
port of the parallel expansion card in expansion 
slot #1 , and the 'ready* light on the disk must 
be glowing a constant red. 

Is the second disk connected and ready 
<y/n>? 

If the disk is not ready , the system should be powered down, and the profile 
attached as described above. Installation may be resumed by going back to 
the beginning of this section. Otherwise, if response is"y'\the system will 
displaythefollowingmessage: 

Making Aisr file system on device /devAisr ... 

The following software installation procedures will now load all files 
beginning with thepath /itsronthe second profile. 

3. Thenextstepistok>adinthesetofXENIXOpemingSystemfloppydisks. It 
is very important in this procedure that the floppydisks be loaded in 
sequentialnumericorder. The next prompt will be: 

Install Operating System distribution. <y/n>? 

type: 

y 

andpresstheRETURNkey. Theprogramdisplaysthefollowingmessagc: 
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For each floppy in the distribution set, insert the floppy 
and answer V . Type me letter V after the last floppy. 
Should you ever see the message: 

tar. please mount new volume, then press RETURN 

insert the next floppy and press the RETURN key. 

4. The //w/o// program will nowprompt: 

First Floppy <y/n>? 

Choose the first floppydisk from the distribution set. (The floppydisks are 
numbered beginning with/.) 

5. insert the floppydisk into the floppy drive, and type a "y** followed by the 
RETURN key.The program copies files from the floppydisk and displaysthe 
nameof each file as it iscopied. 

6. Waitforthemessage: 

Next Floppy <y/n>? 

Remove the first floppydisk from the floppy drive, choose the next 
floppydisk from the set and repeat the last step. Once the system has read 
thisfloppy, it will display: 

checking ownerships and permissions for 
XENIX run-time system ... 

All of the XENIX files necessary to run most 
application software have now been installed. 
You may choose to install the rest of the 
distribution disks later, by running the program 
/etc/install 

if youdonotneedtherestofthe "Operating System" files, goontothenext 
step. Otherwise, continue this procedure until all of the remaining 
"Operating System" floppydisks have been read in. From time to time, 
you will see other messages beginning with "checking ownerships and 
permissions'. These are issued by initialization files that are executed 
automaticallyastheyarereadinfromfloppydisks. 

7. When all floppydisks have been copied, type "n" and press the RETURN 
key when you seethe 

Next Floppy <y,n>? 

message. 

8. WhenitisdonB.theprogramdisplaysthefollowingmessage: 

Operating System installation complete. 

9. The firsttime program will prompt for whether the XENIX Development 
System and XENIXText Processing System are tobe installed at this time. If 
you have only one 5 megabyte disk, you will not have sufficient disk 
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capacity to completely install either of these two packages. The complete 
XENIX System (all three packages) requires about 7 megabytes of disk 
capacity. If you wish to install them at a later time, or not at all, you should 
answer ' V * to the following prompts. When you are ready to install these 
packages, refer to the Installation Notes at die beginning of the XENIX 
Programmer' sGuide or XENIX TextProcessing Guide . 

lfyou choose to install either or bothofthe optional packagesatthistime, the 
sequence of steps is identical to that for installing the XENIX Operating 
System. You may refer to step 3 in this subsection. You will be prompted 
with: 

Install Software Development distribution <y/n>? 

Answer 4 *y" and install this distribution set, or answer "n*'and go on to the 
next distribution set. You will thenbeprompted with: 

Install Text Processing distribution <y/n>? 

Again, answer "y" or "n" depending on which XENIX distribution sets 
youhave purchased. 

10. The last thing the firsttime program does is initialize the lost+fovnd 
directory. The message displayedis: 

making /lost+found directory ... 

11 . OnceinstaUationofallthepackagesiscomplete.theXENIXsystemdisplays 
the message: 

Xenix Installation complete. 
** Normal System Shutdown ** 

12. The system may now be rebooted from the hard disk by turning the system 
off, then on again. Now that the full system has been installed, the boot 
sequence fromtheharddiskisasfollows: 

boot 

Toboot XENIX from the hard disk, press the RETURN key. The system will 
respond: 

pf(0,0)xenix 

and the system will be loaded. Next the system copyright message will be 
displayedandthenthefollowing: 

Type CONTROL-d to continue with normal startup: 
(Type the root passwd to enter system maintenance). 

You should now create the super—user password, as described in the 
following section. 

1.-5.5 Creating the Super-* User Password 

The super— user password keeps the system safe from unauthorized use. It is 
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important that you create a super-user password immediately after the system has 
been installed to ensure maximum protection of the system and prevent unauthorized 
use of the super-user account (for a complete description of the super-user, see the 
XEfilXOperationsGuide). 

Tocreatethesuper-userpassword.followthesesteps: 

1. Press the RETURN key. Tnesystemdisplaysamessageandaprompt: 
Entering System Maintenance Mode 

TERM = (lisa) 
PressweRETURNkey.ThescrecnwiUclear.thendisplay: 
Terminal type is lisa 



2. Type 

passwdroot 

and press theRETURNkey. The system displaysthemessage: 

New password: 

The new password can be any sequence of letters, numbers, and/or 
punctuation marks, butmustbeatleastScharacterslong. 

3. Type the new password and press the RETURN key. The system does not 
display the password as you type so type carefully. After you press the 
RETURN key, the ^stcm displays themessage: 

Retype new password: 

4. Type the new password once more and press the RETURN key. Make sure 
you type it correctly, otherwise the program will ignore the change. If you 
type it incorrectly, you should go back to step two of this section and start 
overagain. 

The super-user password is now in place. From now on, the password will be 
required whenever you attempt to access the systemas the super— user. 

Do not forget the super— user password. Restoring a forgotten super-user password 
requires booting the system from the XENIX Boot floppy. Refer to the chapter on 
"Solving System Problems" section on "Replacing a Forgotten Password" in the 
XENlXOperationsGuide . 

if necessary , keepacopy of thepassword inasafeplace. 

1.5.6 Creating the First User Account 

The last step in the installationistocreatethesystem'sfirstuseracccHim, "guest". The 
"guest" account isa temporary workspace on the system that you may use to practice 
with the XENIX system . Later, after installation is complete and you are familiar with 
the XENIX commands, you can remove the "guest" account and create private 
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accountsforalltheusersonthe system. 
Tocreatethe firstuser account, followthese steps: 

1. Type 

mkuser 

and press the RETURN key. Thesystemdisplaysthemessage: 

Newuser 

Add auser to the system 
Do you require detailed instructions? (y/n/q): 

2. Type ' V ' and press the RETURN key (You can examine the instructions at 
some other time). Thesystemdisplaysthemessage: 

Enter new user's login name: 

3. Type: 

guest 

and press the RETURN key. The name "guest" is now the login name for 
the newuser account. Next, the program asksfortheuser'spassword. 

Enter password: 

4. Just press the RETURN key. This allows you to use the account without 
giving apassword. Next, theprogramasks for agroup name. 

Enter group: 

5. Type 

group 
andpresstheRETURNkey. Finally, the p rogram asks forcomments. 
Please Enter Comment: > 



6. Type 

guest account 

and press the RETURN key. The pro g r am asks if you wish to change 
anything. 

7. Type "n" and press the RETURN key. The program now displays 
informationabout the new account and asks ifyou wish tocreate another. 

8. Type "n" andpresstheRETURNkey. 

The new guest account is now ready. Later, when you turn to the XENIX User's 
Guide, you may use this account to practice logging in, making directories, and 
runningprograms. 
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1.6 The Next Step 

If you are familiar with the XENIX Operating System, you may continue with normal 
startup and begin working. Just hold down the APPLE key and type the letter "d". 
Refer to the explanation of normal startup in the XENIX Operations Guide if you have 
problems. 

If you are not familiar with the XENIX Operating System , we recommend that you hah 
the system and turn to the XENIX User's Guide and the XENIX Operations Guide to 
learn how to start the system, how to log in, and how torunprograms. 

Tohahthe system, followthese steps: 

1. Type 

/etc/haltsys 
and press the RETURNkey. The system displaysthe followingmessage: 
** Normal System Shutdown ** 

2. Turnoffthepowertothecomputer. 

3. Turnoffthepowertotheharddisk. 

Make sure you see the shutdown message before you turn off the computer and hard 
disk. 
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1.7 Upgrade Installation Notes 

1.7.1 Upgrade Overview 

This section is intended for Lisa 11 owners using version 2 of the XENIX operating 
system who wish to upgrade to version 3 . 0. You will begin the upgrade procedure by 
starting the XENIX system from the "boot" floppydisk. Next, you will execute the 
program called upgrade which will will convert the file system on the hard disk to 
XENIX 3.0 format, and copy important utility programs to it. Then you will start the 
system again (this time from the newly converted hard disk) and run the secondtime 
program to copy the rest of the XENIX system program files to the hard disk. Finally, 
you will restore any local files you have installed since you received your version 2. 3 
system. 

The following sectionstellyouhowtoperformeach step. Whenyouhavefinishedthe 
installation, keep this guide and the distribution floppydisks in a safe place. You will 
needthemagainif you wish toreinstall the system for any reason. 

1.7.2 Starting XENIX From a Floppy Disk 

Starting the system is the first step of the upgrade procedure. To do this, you will need 
the distribution floppydisk labeled "Boot". Once you have the floppydisk, follow 
these steps: 

1 . (For those with external hard disks only): Turn on the power to each hard 
disk. 

2. (For those with external hard disks only): Wait for the "ready" light on the 
front of the hard diskdrive(s) to glow a steady red. 

3. Turnonthepowertothecomputer. 

4. Wait foraclick (listenclosely — the click occurs soonafteryouturaonthe 
power). 

5. Hold down the APPLEkey and presstheENTERkey on the numeric key pad 
at the right front corner of the keyboard. The computer will first display a set 
of icons representing each phase of its self— test sequence, and then display 
two numbered boxes. 

6. Now hold down the APPLE key and press the number 3. The computer will 
display amenu of icons representing each of theperipheraldevicesattached 
to the system. 

7. Insert the "Boot" distribution floppydisk into the floppy drive. Make sure 
thatthelabelfacesupandthatyouinsertthesidewiththeauto-shutterfirst. 

8. Hold down the APPLEkey and press the number 2 which should correspond 
to the icon for the floppydisk. The computer reads the XENIX boot program 
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from the floppydisk and begins to execute it . The boot program displays the 
following prompt: 

boot 

Press the RETURN key . 

9. The boot program reads acopy of the version3.0XENIX Operating System 
kernel from the f&cfd(2,0)xenlx and begins to execute it. To show that it is 
reading this file , the program display s the message: 

: fd(2,0)xenix 

Oncethesystembeginstorun, h displays some copyright infoimation, then 
the followingmessage and boot floppy prompt: 

XENIX V3.0 Boot Floppy 

(backspace is *h, erase line is *u) 
Use "hdinit" to initialize hard disk. 
Use "upgrade" to upgrade 2.3 to 3.0 xenix 

1.7.3 Upgrading the File System 

You must now convert the file system on the hard disk using the upgrade program. 
This program converts the file system on the hard disk to version 3.0 XENIX format, 
then copies system programs from the boot floppydisk to the newly converted hard 
disk file system. If you have a second Profile disk, the program also converts the file 
system on this disk and prepares it for receiving user's directories and files during 
normalXENIX operation. 

Toupgradethedisk or disks, foUowthese steps: 

1. lnresponsetotheprompt: 
<BootFloppy> 

type: 
upgrade 

and press the RETURN key. The system reads the program from the boot 
floppydisk,beginstoexecuteitanddisplaysthemessage: 

converting file system to 3.0 ... 

A number of other diagnostic messages will be displayed as the program 
rcadsandwritesthefilesystemV'supcr-blcck". You need not respond to 
any questions; they are allansweredautomaticalry . 

Theupgradeprogramgoesontocopyessentialnlestothehaiddisk.make 
devices and install the new hard disk bootprogram. It also preserves your 
4 Vetc/passwd* ' as ' Vetc/passwd. SAVE ' ' , then copies in the new password 
file. Upgradedisplaysone- linemessages, such as: 

copying files to hard disk ... 

to keep you informed of its progress. 
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2. When the upgrade program is finished, h halts the system, in preparation 
forthenext installation step. You will see themessage: 

** Normal System Shutdown ** 

Youarenowreadytostartthesystemfromtheharddisk. 



Note 



If you are installing XENIX on a LISA 2/5, the hdinit 
program displays the message: 

drivename not on line 

when a profile disk is not connected to the proper parallel 
port or the disk's power is not on. drivename is the 
name of the disk drive (e.g. pfO or pf2). If you see 
the message, check the hard disk connections and make 
sure power is on, then press the RESET button and start 
the installation procedure from the beginning. 



1.7.4 Starting the System From the Hard Disk 

The next step intheupgrade procedure is to start theXENIXsystembyloadingacopyof 
it from the hard diskintomemory. Followthese steps: 

1 . Press the On— Off button on the lower right front face of the Lisa once, to 
powerdown the system. 

2. WaitStolOsecondsandpressthebuttonagain. 

3. The system will first display the self-test icons, auto- load the XENIX boot 
programfromtheharddiskthenprinttheprompt: 

boot 



4. ToloadtheXENIXsystemthathasbeencopiedontotheharddisk.type: 

pf(0,0)xenix 

The computer reads a copy of the XENIX Operating System from the hard 
disk into memory. Once loaded, the system displays the copyright notice 
andthenthemessage: 

Entering System Maintenance Mode 

TERM = (lisa) 
PresstheRETURNkey. Thedisplayscreenclearsand shows: 
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Terminal type is lisa 



terminal type is lisa 

Backup your files, then run /secondtime 



5. If you have installed any of your own files on the disk, take this time to 
archive them to floppydisks. A useful tool for this purpose is tar; see the 
manual page tar(C) in C section of the XENIX Reference if you are 
unfamiliar with its operation. You must use format blank floppydisks 
before using them. You canformatblankdisksby using the diskutU utility. 
Tousediskutfltype: 

/diskutil-f/dev/rfd 

You need not archive the file "/etc/passwd"; the upgrade progr am has 
preservedacopyofyouroldfilein'Vetc/passwd.SAVE". 

Onceyouhavebackedupallofyourfiles,typethecommand 

/secondtime 

followedbyRETURN. 

1.7.5 Copying the XENIX System Files 

The secondtime program copies the XENIX program files from the remaining 
distribution floppydisks to thehard disk. 

1 . The secondtime program begins by asking if there is a second Profile disk 
attached to the system, so that the software may be most efficiently 
distributedonthetwodisks. The system will prompt 

Do you want Aisr to be on a second profile <y/n>? 

2. If you are installing the system on a LISA 2/10, or only have one Profile 
disk, yourresponse shouldbe "n", andyou should goon to the next step. 

Otherwise, the correct response is "y", and the system will display the 
message: 

Before making the Aisr filesystem, the second Profile 
must be connected to the upper parallel port of the 
parallel expansion card in expansion slot #1. 

Is the second disk connected and ready <y/n>? 

If the disk is not ready, the system should be powered down, and the Profile 
attached as described above. ThenturnonpowertothesecondProPile, and 
wait for the "ready" light toglowaconstant red, indicatingthat its self— test 
hascompleted. Installationmay beresumedby going backtothebeginning 
of this section. 

If the disk is ready , you should answer ' 4 y' ', and the system will display the 
followingmessage: 

converting Aisr file system to 3.0 ... 

During the rest of the upgrade procedure, files beginning with the path lusr 
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will be installed onthesecond Profile. 



3. ThenextstepistoloadinthesetofXENIXOperatingSystemfloppydisks. It 
is veiy important in this procedure that the floppydisks be loaded in 
sequentialnumericorder. The next prompt will be: 

Install Operating System distribution. <y/n>? 

type: 

y 

and presstheRETURNkey. The program displays the followingmessage: 

For each floppy in the distribution set, insert the floppy 
and answer "y". Type the letter "n" after the last floppy. 
Should you ever see the message: 

tar please mount new volume, then press RETURN 

insert the next floppy and press the RETURN key. 

4. The </uta// program will nowprompt: 

First Floppy <y/n>? 

Choose the first floppydisk from the distribution set. (The floppydisks are 
numbered beginning with/.) 

5. Insert the floppydisk into the floppy drive, and type a "y" followed by the 
RETURN key. The program copies files from the floppydisk, displaying the 
nameof each file as it iscopied. 

6. Wait for the message: 

Next Floppy <y/n>? 

Choose the next floppydisk from the set and repeat the last step. Once the 
system has read this floppy, it will display: 

checking ownerships and permissions for XENIX run— time system .. 

All of the XENIX files necessary to run most application software 
have now been installed. You may choose to install the rest of the 
distribution disks later, by running the progr am 
/etc/install. 

If you do not need the rest of the XENIX Operating System files, goon to the 
next step. Otherwise, continue this procedure until all of the remaining 
XENIX OperatingSystemfloppydiskshavebeenreadin. From time totiroe, 
you will see other messages beginning with "checking ownerships and 
permissions*. These are issued by initialization files that are executed 
automatically as they are read in fromfioppydisks. 

7. When all floppydisks have been read in, type " n" and press the RETURN 

key when you see the 
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Next Floppy <y,n>? 
message. 

8. The last thing the secondtime program does is initialize the lost+found 
directory. Themessagedisplayedis: 

making /lost+found directory ... 

9. Once installation of all thepackages iscomplete, the XENIX systemdisplays 
the message: 

XENIX Installation complete. 

** Normal System Shutdown ** 

10. The system should now be rebooted from the hard disk by turning the 
system off, then on again. Now that the full system has been installed, the 
bootsequencefromtheharddiskisasfollows: 

boot: 

To boot XENIX from the hard disk, press the RETURN key. The system will 
respond: 

pf(0,0)xenix 

and the system will be loaded. Next a copyright message and some 
configurationinformationwillbedisplayedandthenthe following: 

Type CONTROL— d to continue with normal startup: 
(Type the root passwd to enter system maintenance). 

You should nowrestore files thatyou had backed up. 

1.7.6 Restoring Your Files 

Press the RETURN key to enter system maintenance mode. Locate the floppydisks 
with your personal files, and reinstall these files onto the hard disk. Use the df 
command tomakecertainyou have enough disk space for the restorations. 

If you have modified the file I etc) passwd since you received your version 2 XENIX 
system, you will have to edit the new3.Q/etc/passwd file nowresidentonthe hard disk. 
Use the text editor vi (or some other editor) and "Yank" entries, line by line, from 
/etc/passwd.SAVE (your old password file), and "put" them in /etc/passwd, being 
careful not to duplicate user id numbers. Each ofthe 3.0 entries is necessary to assure 
correct ownership of the newXENIX system files. 

1.7.7 The Next Step 

Since you are familiar with the XENIX Operating System, you may continue with 
normal startup and begin working. Just hold down the APPLE key and type the letter 
4 *d' ' . Refer to the explanation of normal startup in theXENIX Operations Guide if you 
have problems. 
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Tohalt the system, follow these steps: 

1. Type 

/ctc/haltsys 
and presstheRETURN key. The sy stem displays the following message: 
** Normal System Shutdown ** 

2. Turnoffthepowertothecomputer. 

3. Turnoffthepowertotheharddisk. 

Make sure you see the shutdown message before you turn off the computer and hard 
disk. 
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1.1 Installing XENIX 

To install the XENIX Operating System onyour computer forthe first time, you should 
refer to the XENIX Installation Guide found in the front of this binder. It provides you 
with step— by —step instructions on how to install the distribution floppies for all three 
XENIX packages (Operating System, Development System, and Text Processing 
System), how to initialize your hard disk, andhow to create the super— userpassword. 

If you purchased the XENIX Development System and Text Processing packages 
separately from the XENIX Operating System, you should refer to the Installation 
Notes included with those packages. The notes explain how to use the letclinstall 
utility to install the distribution floppies. 

1.2 Overview 

The XENIX Operating System is a powerful system of programs which allow you to 
accomplish a full spectrum of tasks, from developing high— level and assembly 
language programs to creating, editing, and typesetting documents. In many cases, 
the XENIX system uses the full resources of your computer, giving it the power of a 
much larger machine . To keep this powerful machine running smoothly , the XENIX 
system requires careful control of its operation and a regular schedule of maintenance. 
This guide explains how to operate and maintain the XENIX operating system on your 
computer, ensuring maximum performance with the least number of system 
problems. 

As a special feature, this guide also describes how to expand a XENIX system with a 
Micnet network. A Micnet network allows serial communication between all the 
XENIX systems in your work environment. The Micnet programs and commands 
include the netntil program, which is used to install the network, and the mail, rep, 
and remote commands, which are used to pass messages, files, and commands over 
the network. 

1.3 The System Manager 

Every XENIX system should have at least one person in charge of system maintenance 
and operation. In this guide that person is called the system manager. It is the system 
manager' s duty to ensure the smooth operation of the system and to perform for other 
users tasksthatrequire special privileges. 

Since a XENIX system may consist of any where from a single computer to dozens of 
computers connected ina network, the system manager'sjob can be aonce— a— week 
task or a full— time job. No matter what the size of the system, the system manager 
should faithfully perform each required maintenance task, since sloppy maintenance 
can affect thcperformanccofthc XENIX system. 

All tasks in this guide are presented from the system manager's point of view, but 
many of them may be accomplished by an ordinary user. Since some of the tasks 
dramatically change the system's operation, we recommend that the system manager 
perform these tasks whenever possible. This can prevent unwanted or .unnecessary 
changes to the system. 
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1.4 The Super-User Account 

The super-user account is a special account for performing system maintenance 
tasks. It permits the system manager unusual privileges that ordinary users do not 
have, such as accessing all files in the system and executing privileged commands. 
Many of the tasks presented in this guide require that the system manager be logged in 
as the super-user. To do this, the system manager must know the super-user 
password created during the installation of the XENIX system (see the XENIX 
InstallationCuide). 

Users who are authorized to act as the super-user, including the system manager, 
should log in as the super— user only whennecessary to perform a system maintenance 
task. Even if the system manager is the only person using the system, he should create 
a user account for himself and u se it for day — to— day work, reserving the super— u ser 
accountforsystemmaintenancetasksorJy. 

The number of individuals who are given the super-user password should be kept to a 
minimum. Misuse of the super— user powers by naive users can result in lost data, 
programs, andeventhe XENIX system itself. 

1.5 The Keyboard 

Many keysandkeycombinationshavespecblmeaningsto the XENIX system. These 
keys and key combinations have special names that are unique to the XENIX system 
and may or may not correspond to the keytop labels on your keyboard. To help you 
find the special keys, the following table shows which keys on the Lisa terminal 
correspond to XENIX system keys. In this table, a hyphen (— ) between keys means 
"holddownthefirstkeywhilepressingthesecond." 



XENIX Name Lisa Keytop Action 



BREAK 



Apple— C 



BACKSPACE 


Backspace 


CNTRL-D 


Apple-D 


CNTRL-H 


Apple— H 


CNTRL-Q 


Apple— Q 


CNTRL-S 


Apple— S 


CNTRL-U 


Apple- U 



Stops current action and returns to the 
shell. This key is also called the 
INTERRUPT key. 

Deletes the first character to the left of 
the cursor. 

Signals the end of input from the 
keyboard; alsoexits current shell. 

Deletes the first character to the left of 
the cursor. AlsocalledtheERASEkey. 

Starts printing after it has been stopped 
withCNTRL-S. 

Stops printing at the standard output 
device (does not stop the program) . 

Deletes all characters on the current 
line. AlsocalledtheKlLLkey. 
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Apple— \ Quits current command and creates a 

core file (Recommended for 
debugging only). 

ESCAPE Clear Exits the current mode; for example, 

exits insert mode when in the editor vi . 



Note 



If your keyboard does not have an key (a key with an apple on it), use the 
COMMAND key instead. 



1.6 Using This Guide 

The tasks presented in this guide range from very simple tasks requiring very little 
knowledge about XENIX to quite complex tasks requiring extensive knowledge about 
XENIX and your computer. 

To help you complete a task, each chapter explains the tools and knowledge you need 
to complete the tasks described in that chapter. In some cases you may be required to 
seek instruction in another manual, such as the XENIX User's Guide . In most cases, 
however, following the instructions will be sufficient. 

Chapter 1 introduces this guide. 

Chapter 2 explains how to start and stop the XENIX system and how to log in as the 
super— user, the XENIX system's special system manager account. 

Chapter 3 explains how to create accounts for the users who work on your system , how 
to assign groups, andhowtomanage user IDs. 

Chapter 4 explains how to create and mount file systems, how to set permissions, and 
howtokeepthesystemsecure. 

Chapter 5 explains how to maintain free space on the root file system and other file 
systems. 

Chapter 6 explains how to create backup copies of the root file system and other file 
systems. 

Chapter7explainshowtoadd terminals and other peripheral devicesto the system. 

Chapter 8 explains how to solve system problems such as a jammed lineprinter or a 
forgottenpassword. 

Chapter9explainshowtocreateamuhiple sy stem mailing network withMic net. 

Appendix A presents a list of the XENIX system special files and explains how to use 
these files whencrcatingandraaintainingfile systems. 
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AppcndixBlUts the nrastcoimnonlyuscdXENIXsystemdirectoricsaiM] files. 
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Starting and Stopping the System 

2.1 Introduction 

This chapter explains how to start and stop the XENIX system. It also explains how to 
log in as the super— user. 

2.2 Starting the System 

Starting a XENIX system requires more than just turning on the power. The first step is 
to install the XENIX Operating System on your computer. Refer to the XENIX 
InstaUationGuide for instructions on how to do that. You must also perform a series of 
steps to initialize the system for operation. Starting the system requires: 

— Bootingthe operating system 

— Cleaningthe file system (ifthe system was improperly stopped) 

— Choosing the mode of system operation 

The following sections describe each of these procedures. 

2.2. 1 Booting the Operating System 

The first step in starting the system is to boot the operating system from the hard disk. 
Follow these steps: 

1 . Turn on power to the hard disk. If you have two hard disks, turn on the 
powertoboth. 

2. Wait for the ' 'ready" light on the front of the hard disk drivc(s) to glow a 
steady red. 

3. Turnonpowertothecomputer. 

4 . The computer displays self- test icons (as when XENIX was first installed 
on the computer). It then loads the XENIX ' 'bootstrap' ' program from the 
hard disk, and the program displays the message: 

Xenix boot 



5. Pressthe key. The system will display 

pf (0,0) xenix 

and the bootstrap program loads the XENIX operating system from the hard 
disk. 

When the system is booted, it displays information about itself and checks to see ifthe 
' 'root file system' * (i. e. , all files and directories on the hard disk) is clean. If it is clean , 
you may choose the mode of operation. If not, the system requires you to clean the file 
system before choosing. 
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2.2.2 Cleaning the F&e System 

You mustclcanthc file system whcncveryou see the the message: 

Proceed with cleaning (y or n)? 

while booting the system. The system displays this message if it was not stopped 
properly (i.e., as described in the section "Stopping the System"). The XENIX 
operating system requires a clean file system to perform itstasks. 

To clean the file system, type y (for ' 'yes") and press the key. The system cleans the 
file system, repairing damaged files or deleting files that cannot be repaired, and 
repoitsonitsprogressaseachstepiscompleted. At some point, it may ask if you wish 
to salvage a file. Alwaysanswerbytypingvandpressingthekcy. 

When cleaning is complete, the system usually asks you to choose the mode of 
operation, but itmay alsodisplay the message: 

** Normal System Shutdown ** 

If h displays this message, you must reboot the system. Youcandothisby pressingthe 
RESET buttonandrepeatingthestq)sgivcnintheprevioussection. (You will not have 
to turn on the power to the harddisk(s)or computer.) 

2.2.9 Choosing the Mode of System Operation 

You may choose themode of XENIX operation as soon as you see the message: 

Type CONTROL- d to continue with normal startup, 
(or give the root password for system maintenance): 

The system has two modes: normal operation and system maintenance mode. Normal 
operation is for ordinary work on the system. This is the mode you should choose to 
allow multiple users to log in and begin work. System maintenance mode is a 
specialized mode reserved for work to be done by the system manager. It does not 
allow multiple users. 

To choose normal operation, press the key. The system displays a startup message 
and begins torunthe special command file/e/c/rc described in Chapter 7. 

To choose system maintenance mode, type the super-user's password (sometimes 
called the ' 'root password") and press the key. The system displays the message of 
the day and the super— user's prompt (#). The commands in the letclrc file are not 
executed. (Choose system maintenance mode only if you must do system 
maintenance work that requiresallotheruserstobeoff the system.) 

2.3 Logging In as the Super-User 

Many system maintenance tasks required that you log in as the super - user before you 
may perform the task. For example, you must be logged in as the super— user to stop 
the system as described in the next section. 

Before you may log in as the super— user, you need the super— user password. You 
also need to see the ' 'login: ' ' message on your terminal's screen. 1 f you do not see the 
message, press the key. 
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To log in as the super— user, follow these steps: 

1. Typethesuper— user'sloginname: 

root 
and press the key. 

2. Typethesuper— user'spasswordandpressthe key. 

The system opens the super- user account and displays the message of the day and the 
super— user prompt (#). 

Take reasonable care when you are logged in as the super— user. In particular, you 
should be very careful when deleting or modifying files or directories. Avoid using 
wildcard designators in filenames and frequently check your current working 
directory. Even small errors can cause annoying and unwanted changes to the system 
and user files. Insomecases.amistakernaycauseirretrievabledamagetoafile. 

You may leave the super- user account at any time by pressing 

2.4 Stopping the System 

Stopping the XENIX system takes more than just turning off the computer. You must 
prepare the system to be stopped by running either the shutdown or the haltsys 
command. ThefoUowingsectkmsdescribeeachcommand. 

2.4. 1 Using the shutdown Command 

The shutdown command is the normal way to stop the system and should be used 
whenevcrthe system is in normal operation mode. It warns other users that the system 
is abouttobe stopped and gives them an opportunity to finish their work. 

Tost op the system with theshutdown command, followthese steps: 

1. Log in as the super-user (see the section "Logging in as Super— User" in 
this chapter). The system opens the super— user account and displays the 
messageof die day and the super-uscr'sprompt . 

2. Type: 

/etc/shutdown 

and press the key. The system loads the shutdown command. The 
command asks for the number of minutes before you wish to stop the 
computer. 

3. Type a number from to IS and press the key. The system displays a 
warning message at each terminal, asking logged in users to finish their 
work and logout. As soonasallusersare logged out or the specified time has 
elapsed, the system closesallaccounts, displays the message: 

** Normal System Shutdown ** 

and stops. You may now turnoff the computerand hard disk. 
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2.4.2 Using the haltsys Command 

The haltsys command may be used to hah the system immediately. In general, it 
should be used only when no other users are on the system or when the system is in 
system maintenancemode. 

To stop the system with the baltsys command, follow these steps: 

1. lx%masthesuper^user(notrequiredwheninsystemmaintenancemode). 
The system opens the super-user account and displays the message of the 
day andthe super-user prompt. 

2. Type: 

/etc/haltsys 
and press the key. The system displaysthe message: 

** Normal System Shutdown ■** 
and stops. Youmaynowturnoffthecomputerandharddisk. 
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Preparing XENIX for Users 



3.1 Introduction 



User accounts help the XENIX system manager keep track of the people using 
the system, and control their access to the system's resources. Ideally, each 
user should have a user account. Each account has a unique "login name" and 
"password" with which the user enters the system, and a "home directory" 
where the user does his work. 

It is the system manager's job to create accounts for all users on the system. It is 
also the manager's job to maintain user accounts by changing user passwords, 
login groups, and user IDs when necessary . 

This chapter explains how to: 

— Add user accounts to the system 

— Change an account's password 

— Force new passwords 

— Create a group 

— Change an account's login group 

— Change an account's user ID 

— Remove user accounts from the system 
The following sections describe each in detail. 



3.2 Adding a User Account 

You may add a user account to the system with the mkuser program. The 
program creates a new entry in the XENIX system's /etc/pae$wd file. This 
entry contains information about the new user, such as login name and initial 
password, that the system uses to let the user log in and begin work. The 
program also creates a home directory for the user, a mailbox for use with the 
mail command, and a .profile file which contains XENIX commands that are 
executed when the user logs in. 

To create a new user account, follow these steps: 



1. Log in as the super-user. 

2. Type 
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mkuser 



and press the RETURN key. The system displays the following 
message: 

Newuser 



Add a user to the system 
Do you require detailed instructions? (y/n/q): 

3. Type the letter y (for "yes"), if you want information about the 
program, otherwise type the letter n (for "no"). (Type j(for "quit") 
only if you wish to stop the program and return to the system.) 

When the program continues, it asks you you to enter the new user's 
login name: 

Enter new user's login name: 

The login name is the name by which XENIX will know the user. It is 
usually a short version of the user's actual name, typed in lowercase 
letters. For example, either "johnd" (a first name and last initial) or 
"jdoe" (a first initial and last name) is acceptable for the user John 
Doe. 

4. Type the new name, and press the RETURN key. The program asks 
you for the initial password: 

Enter password: 

The initial password is the password you assign to the new user. The 
user will use the initial password to enter his account for the first time. 
Once in the account, the user should create a new password for 
himself, one that is hard to guess. (See the section "Changing Your 
Password" in the XENIX Uter '§ Guide.) 

5. Type the password carefully, and press the RETURN key. After you 
have entered the password, the program asks for the group name: 

Enter group: 

The group name is the name of the group of users to which the user 
will belong when he logs in. Users in a group have access to a common 
set of files and directories. The group name is optional. If not given, 
the the XENIX system's common group "group" (with group ID 50) is 
used. 
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Type the group name, and press the RETURN key. If you do not wish 
to enter a group name, just press the RETURN key. After you have 
entered the group, the program asks for a comment: 



Please enter Comment > 

> 

A comment is information about the new user, such as his department 
and phone extension. Although, the comment is optional, it is useful if 
the ringer command is often used to display information about users. 
If given, the comment must be no more than 20 characters long, 
including spaces. It must not contain any colons (:). The example 

John Doe, 123 

shows the recommended form for a comment. 

7. Type the comment. Make sure it is 20 characters or less. If you do not 
wish to enter a comment, just press the RETURN key. 

The program now shows what you have typed and the special user 
entry that it has created for the new user. This entry is copied to the 
special system file /etc/paeawd. The entry shows the login name, the 
password (encrypted), the user ID, the group ID, the comment, the 
user's home directory, and the startup program. Items in the entry 
are separated by colons (:). (For a full description of each item, see 
pat8wd(M) in the XENIX Reference Manual.) 

The program then gives you an opportunity to change the user name, 
password, group, or comment: 

Do you want to change anything? (y/n/q): 

8. Type the letter y (for "yes") and press the RETURN key, if you wish to 
change something. Type n (for "no") and skip to step 10 if you wish to 
complete the new account. (Type q, for "quit", only if you wish to 
le ave the pr ogr am an d abort the new account. ) 

9. If you type y in step 8, the program asks for the item you wish to 
change: 

username 
password 
group 
comment 

Type the name of the item you wish to change, then type the new 
item. The program changes the item and returns to step 8. 
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10. Once you type n in step 8, the program displays the message: 

Password file updated 

followed by a description of the actions it has taken to add the new 
user account to the system. The program then asks if you wish to add 
another user to the system. 

11. Type y if you wish to add another user. Otherwise, type n to stop the 
program and return to the super-user prompt. 

A user can log into a new account as soon as it is created. See the XENIX User's 
Guide for details. 

3.3 Changing a User's Password 

Normally, an ordinary user can change the password of his own account with 
the passwd command (see the XENIX User's Guide). Sometimes, however, it 
may be necessary for the super-user to change the password for him, for 
example, if the user has forgotten his password and cannot get into the account 
to change it. The super-user may change the password of any user (including 
himself) with the passwd command. 

To change a password, follow these steps: 

1. Log in as the super-user. 

2. Type 

passwd login-name 

(where login-name is the user's login name) and press the RETURN 
key. The command displays the message: 

New password: 

3. Type the new password and press the RETURN key. The command 
does not display the password as you type it, so type carefully. The 
command asks you to type the password again: 

Retype new password: 

4. Type the password again and press the RETURN key. 

To see how an ordinary user can change his own password with the paeewd 
command, see the RETURN User's Guide . 
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3.4 Forcing a New Password 



From time to time, a user account may need a higher level of security than 
ordinary. Since the security of any account depends its password, it is 
important to keep the password as secret as possible. One way to provide 
greater security is to force users to change their passwords on a regular basis. 

You can force users to change their passwords by using the pwadmin 
command. This command automatically dates each password and requires the 
user to provide a new password when the specified number of weeks have 
passed. The command also requires users to wait a minimum number of weeks 
before allowing them to restore their previous password. 

To use the pwadmin command, you must log in as the super-user. You also 
need to choose a minimum number of weeks that a user must wait before 
changing his password and a maximum number of weeks that a user may go 
without changing the password. A common pair of minimum and maximum 
values is 2 and 8. 

To set the minimum and maximum dates, type: 

pwadim -min num -max num login-name 

where num is a number in the range 1 to 63, and login-name is simply the login 
name of the user whose passwordyou are administering. 

If you are unsure of the current minimum and maximum values for a password, 
you can display them by typing: 

pwadmin -d login-name 
This command does not change the current values. 
If you wish to force a user to change his password immediately, type: 

pwadmin -f login-name 

The user is asked on his next login to supply a new password. 

When a password no longer requires extra security, you can remove the current 
minimum and maximum values for the password by typing: 

pwadmin -n login-name 

The system will no longer prompt for changes. 
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3.5 Creating a Group 

A group is a collection of users who share a common set of files and directories. 
The advantage of groups is that users who have a common interest in certain 
files and directories can share these files and directories without revealing them 
to others. Initially, all users belong to the common system group named 
"group", but you can create new groups by modifying the XENIX system file 
/etc/ group using a XENIX text editor. 

To create a new group, you need to choose a group name and a group 
identification number (group ID). You also need to make a list of the users in the 
new group. The group name may be any sequence of letters and numbers up to 
eight characters long, and the group ID may be any number in the range to 
65535. Both the group name and ID must be unique, i.e. , they must be not be the 
same as any existing group name or ID. 

To create a new group, follow these steps: 



1. Log in as the super-user. 

2. Display the contents of the /etc/ group file by typing: 

cat /etc/group 

and pressing the RETURN key. The cat command displays the 
contents of the /etc/ group file. The file contains several entries, each 
defining the group name,, group ID, and users for a group. Each entry 
has the form: 

group-name::group-ID:ueere 

The users are shown as a list of login names separated by commas (,). 
For example, atypical file may look like this: 

other:x:l:demo 

sys:x:2: 

group::50:johnd,suex 

3. Check the /etc/group file entries to see that the group name and ID 
you have chosen are unique. 

4. If the group name and ID are unique, invoke a XENIX text editor (see 
the XENIX U$er'$ Guide) and specify /etc (group as the file to edit. 

5. Locate the last line in the file, then insert the new entry in the form 
given above. For example, if you wish to create a group named 
"shipping" with group ID "142" and users "johnd", "marym", and 
"suex", type: 
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shipping:: 142:johnd,marym,suex 

6. Exit the editor. 

To make sure you have entered the group names correctly, use the grpcheck 
command to check each entry in the /etc/ group file. If the new entry is free of 
errors, no other changes to the file are required. 

You can create any number of new groups. Each group may have any number 
of members. Furthermore, any user may be a member of any number of 
groups. Multiple group membership is especially convenient for users who 
have interests that span a variety of areas. 

If a user is a member of several groups, he can gain access to each group by using 
the newgrp command. See the XENIX Ueer'e Gut it for details. 

3.6 Changing a User's Login Group 

When a user logs in, the system automatically places the user in his "login 
group". This is the group given by the group ID in the user's /ete/passwd file 
entry (see the section "Adding a User Account" in this chapter). You can 
change the user's login group by changing the group ID. To change the group ID 
you need the group ID of the new login group, and you need to know how to use a 
XENIX text editor (see the XENIX Use r '* Guide ). 

To change the group ID, follow these steps: 



1. Log in as the super-user. 

2. Use the cd command to change the current directory to the fete 
directory. Type: 

cd /etc 

3. Use the cp command to make a copy of the / etc/ pa$ewd file. Type: 

cp passwd passwd+ 

4. Invoke atext editor and specify /etc/pat$wd+ as the file to edit. 

5. Locate the desired user's password entry. Each entry begins with the 
user's login name. 

6. Locate the user's group ID number in the user's password entry. It is 
the fourth item in the entry. Items are separated by colons (:). For 
example, the entry 
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marym:9iKlwp:205:50:Mary March, 122:/usr/marym:/bin/sh 
hasgroupID"50". 

7. Delete the old group ID and insert the new one. Be sure you do not 
delete any other portion of the user's password entry. 

8. Exit the editor. 

0. • Use the mv command to save the old / etc/ pa$$v>d file. Type: 

mv passwd passwd- 

10. Use the mv command to make the edited file the new /etc/pa$$v>ord 
file. Type: 

mv passwdH- passwd 

You can make sure you have entered the new login group correctly by using the 
pwcheck command. If the new entry is correct, no other changes to the file are 
required. 

You must not change the group IDs for system accounts such as "cron" and 
"root' 1 . System accounts are any accounts whose user IDs are less than 200. 
The user ID is the third item in the password entry. 

Note that changing a user 's login group does not change the "group ownership" 
of his files. Group ownership defines which group has access to a user's files. If 
users in the new group wish to access the user's files, you must change the group 
ownership with the chgrp (for "change group") command. For details, see the 
section "Changing Group Ownership" in Chapter 4. 

3.7 Changing a User ID 

Sometimes it is necessary to change the user ID in a user's account entry to 
allow a user to access files and directories transferred from other computers. In 
particular, if a user has different accounts on different computers and 
frequently transfers files and directories from one computer to another, then 
the user IDs in each of his account entries must be made the same. You can 
make them the same by modifying the account entries in the / etc /pa»$v>d file. 

Tochange auser ID, follow these steps at every computer for which the user has 
an account: 

1. Log in as the super-user. 

2. Use the cd command to change the current directory to the /etc 
directory. Type: 
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cd /etc 

3. Use the cp command to make a copy of the / etc/ paeswd file. Type: 

cp passwd passwd+ 

4. Invoke a XENIX text editor and specify /etcfpa$$v>d+ as the file to 
edit. 

5. Locate the user's account entry. Each entry begins with the user's 
login name. 

6. Locate and substitute the current user ID. The ID is the third item in 
the entry. For example, the entry 

marym:9iKlwp:205:50:Mary March, 122:/usr/marym:/bin/sh 

has user ID "205". 

7. Exit the text editor. 

8. Use the rav command to save the old f etc/ paeewd file. Type: 

mv passwd passwd- 

9. Use the mv command to make the edited file the new / etc/ pa8$wd file. 
Type: 

mv passwd+ passwd 

No other changes to the file are required. 

In most cases, you can change the user ID to the same number as the user's 
most-used account. But the new number must be unique at every system for 
which the user has an account. If there is any conflict (for example, if the 
number already belongs to another user on one of the systems), you must 
choose a new number. You can choose any number greater than 200. Just 
make sure it is unique, and that you copy it to all systems on which the user has 
an account. 

Once a user's ID has been changed, you must change the "user ownership" of 
the user's files and directories from the old user ID to the new one. You can do 
this with the chown (for "change owner") command described in Chapter 4, 
"Using File Systems." For example, to change the ownership of johnd's home 
directory, type: 

chown johnd /usr/johnd 

Note that you may use the find command described in Chapter 6, "Backing Up 
File Systems," to locate all files and directories with the user's old user ID. 
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3.8 Removing a User Account 

It is sometimes necessary to remove a user account from the system. You can 
remove a user account with the rmuser program. The program deletes the 
user's entry from the / etc/ paeewd file and removes the user's home directory 
and mailbox. 

Before you can remove the user account, you must remove all files and 
directories from the user's home directory, or move them to other directories. 
If you wish to save the files, you may use the tar command to copy the files to a 
floppy disk (see the section "Copying Files to a tar Disk" in Chapter 6). 

To remove a user account, follow these steps: 



1. 


Log in as the super-user. 


2. 


Type: 




cd J wst /login-name 



and press the RETURN key to change to the user's home directory. 
The login-name must be the user's login name. 

3. Make sure that you have made copies of all important files and 
directories in the user's home directory. 

4. Use the rm (for "remove") command to remove all files and 
directories from the user's home directory. This includes any files 
that begin with a period (.). Directories can be removed by using the 
— r (for "recursive") option of the rm command. For example, the 
command 

rm -r bin 

removes the directory named bin and all files within this directory. 

5. After removing all files and directories, make sure the user's mailbox 
is empty. Type: 

cat /usr/spool/mail/ login-name 

and press the RETURN key, where login-name is the user's login 
name. If the mailbox contains text, then type: 

cat /dev/null >/usr /spool /mail//© gin-name 

and press the RETURN key. 
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6. When the user's home directory and mailbox are empty, type: 

cd /usr 

and press the RETURN key. The user's home directory cannot be 
removed until you have moved to another directory. 

7. Type: 

rmuser 

and press the RETURN key. The program displays a message 
explaining how to remove a user: 

****rmuser-remove a user from the system**** 

Press ENTER when you are ready. 

The program asks for the login name of the user you wish to remove: 

Enter name of id to be removed. 

8. Type the user's login name. You should now see the message: 

Removing user name from the system. CONFIRM? (y/n/q): 

9. Type y (for "yes") to remove the user from the system. Otherwise 
type n (for "no") to stop the removal, or q (for "quit") to stop the 
program. The program removes the user's entry from the 
I etc/ paeewd file, the user's mailbox, .profile file, and home directory. 
The program displays the message: 

User name removed from the system 

The program now gives you a chance to remove another user: 

Do you want to remove another user? (y/n/q): 

10. Type y to remove another user. Otherwise, type n or q to stop the 
program. 

Note that the rmuser program will refuse to remove an account that has a 
system name, such as "root", "sys", "sysinfo", "cron", or "uucp", or asystem 
ID (user ID below 200). Also, the program cannot remove a user account if the 
user's mailbox still has mail in it, or if the user's home directory contains files 
other th an. profile. 
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4.1 Introduction 

This chapter describes one of the most important responsibilities of a system manager 
controlling and recording users' access to the files and directories on the system. It 
introduces file sy stems, permissions, system security, and process accounting. 

4.2 FUe Systems 

Afile system is the XENIX system's way of organizing storage on mass storage devices 
such as hard and floppy disks. A file system consists of program and data files, 
directories, and the information needed to locate and access these items. 

Each XENIX system has at least one file system. This file system is called the "root" 
file system and is represented by the symbol"/". Thcroot fids system containsallthc 
XENIX program and data fifesand usually contains all the user directories as well . 

A XENIX system may also have other file systems, for example, a file system that 
contains only user directories or application programs. Such file systems must be 
specifically created by a userandthenmountcd onto the system. 

You can create a file system with the mkfs command. This command sets the size and 
format of the file system and may also copy some files to the new system. You can 
mount a file system with the mount command. Once mounted, you may access the 
files and directories in the file system as easily as files and directories in the root file 
system . (The root file system is permanently mounted. ) When you are finished with a 
fifesystem.ycucanunmcvntitwiththeninoantcommand. 

One reason for creating new file systems istoexpand the available storage space of the 
system. Each mounted fife system adds its free space to the system's total storage 
space. You may create a new file systemon ahard or floppy disk , mount it , and then use 
it s free space for your work , lea ving the limited space in the root fife system for XENIX 
system files. 

Another reason for creating new fife systems isto establish a collection of floppy disks 
that contain application programs and data fifes. You may then mount and unmount 
fife systems andusetheprograms and filesaccordingto your needs. 

The following sections explain how tocreate and use file systems. 

4.2.1 Creating* File System 

You can create a file system on a floppy disk with the mkfs command. You need a 
formatted floppy disk, the special filename of a floppy disk drive, the disk block size, 
and special numbers called the gap and block numbers. A floppy disk can be formatted 
by following the instructions in the section ' 'Formatting Floppy Disks' ' in this chapter. 
The special filenames for the disk drives, the disk block size, and the gap and block 
numbers depend on the specific system and are given in Appendix A. 

Note that if a fife system already exists on the disk, it will be destroyed by this 
procedure. For this reason, be particularly careful not to create a new file system on the 
root file system. If you destroy theroot fife system, you will have to reinstall the XENIX 
system. 
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Tomake a file system ona floppy disk, foUowthese steps: 

1. Login. You do m* have to be logged in as the super-user touse the mlrfs 
command. 

2. lnsmaformattedfloppydiskintoafloppydiskdrive. Make sure there is no 
read-onrytabonthediskjacket. 

3. Type 

/etc/mkfs specialfiie btocksize gap Mock 

(where specialfiie ,blocksize ,gap , and block are supplied by you) and press 
the key. The system automatically creates the file system. If it discovers 
data already on the disk, the system displays the message: 

mkfs: specialfiie contains data. Overwrite? (y/n): 

If you are sure the disk contains nothing that you want to save, type y and 
press the key to overwrite the data and continue creating the file system. 
Otherwise, type n . If you type end, no file system iscreated. 

For example, the following command creates a file system on the floppy disk drive 
/<fev//</withbtocksize 800andgapandblocknumbers2and 16. 

/etc/mkfs /dev/fd 800 2 16 

4.2.2 Mounting a File System 

Once you have created a file system, you can mount it with the mount command. To 
mount a file system you need the the special filename of a floppy disk drive and the 
name of the directory onto which the file system is to be mounted. The special filename 
of the disk drive containing the disk with the file system depends on the specific system 
and is given in Appendix A. The directory to receive the file system may be any 
directory as long as it is empty (contains no files) and is not your current working 
directory. Note that the directory Imnt is specifically reserved for mounted file 
systems. 

Tomount a file system, followthese steps: 

1. Log inas the super— user. 

2. lnsenthediskcontainingthefilesystemintoafloppy disk drive. 

3. Type the appropriate mount command and press the key. The command 
shouldhave the form 



/etc/mount specialfiie directoryname 

where specialfiie is the special filename of the disk drive and directoryname 
is the name of the directory to receive the file system. If the disk has a 
read-only tab, make sure you include the switch "— r" at the end of the 



For example , the following command mounts a file system on a disk in the disk drive 
/dev/fdonio the directory named /account. 
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/etc/mount /dcv/fd /account 

Remember to make sure that the specified directory is empty before issuing the 
command. Ifthecommanddisplaysthemessage: 

mount: Structure needs cleaning 

use the f sck command to clean the file system and try to mount it again (see the section 
' 'File System Integrity' ' in Chapter 5). If the command displays the message: 

mount: Device busy 

either the file system lias already been mounted and cannot be mounted twice, or a user 
is currently in the directory in whkhyou wish tomount the file system. 

To check that the file system was properly mounted, use the cd command to change to 
the directory containing the mounted system and the 1 command to list the contents. 
The command displays the files and directories (if any) in the file system. Be sure to use 
the cd command to lea ve the directory after finishing your work in it . 

Note that frequently used file systems can be mounted automatically when starting the 
system by appending the appropriate mount commands to the letclrc file. See the 
section "Changingthe/erc/rcFik ,, inChapter8fordctaib. 

4.2.3 Unmounting a File System 

You can unmount a mounted file system with the amount command. Unmounting a 
file system does not destroy its contents. It merely removes access to the files and 
directories in the file system. 

Tounmountamountedfilesystem.type: 

/etcAunount special/He 

and press the key. The special/He is the name of the special file corresponding to the 
disk drive containing the disk with the file system. The command empties the directory 
that previously contained the file system and makes the directory and the 
corresponding disk drive available for mounting another file system. 

For example, the following command unmounts a file system from the disk drive 

Idevlfd: 

/etc/umount /dev/fd 

Before unmounting a file system, make sure that no files or directories are being 
accessed by programs being run by you or by other users. The umount command 
displaysthe message: 

umount: Device busy 

if you oranotheruseris currently in the directory containing the file system. 

4.2.4 Formatting Floppy Disks 

You can format floppy disks with the formatfC) program. Formatted disks are 
required whenever you create a file system and when you backup a file system with the 
sysadmin program (see Chapter 6, ' 'File System Backups' ' ). 
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In general, the system manager should format spare floppy disks in advance. To 
format a floppy disk , follow these steps: 

1. Type 

format -v 
and press the key. The - vflag specifies vcrbose(orinteractivc)inode. 

2. format willrespond 

insert disk 

3 . Afterthc programhas finished formatting the disk, it will prompt: 

type <RETURN> to format another disk, *q* to quit 

If you wish, you may use the — f flag to format your disks. The program formats the 
givenfile. Thcdefaultdeviceis/dcv/rfd. The command 

format -f /dev/nrfd 

formats the disk using the no- eject device . 



Note that formatting removes all data from the disk, so if you are formatting a disk that 
already contains data, make sure that the data is nothing you wish to save. 

4.3 Permissions 



Permissions are the way the XENIX system controls access to all the files and 
directories. In XENIX, an ordinary user may access those files and directories for 
which hehaspermission. All other files and directories are inaccessible to him. 

There are three different levels of permissions: user, group, and other. User 
permissions apply to the owner of the file; group permissions apply to users who have 
the same group ID as the owner, and other permissions apply to all other users . 

4.3.1 Displaying Permissions 

You can display the permission settings for all the files in a directory with the 1 
command. This command lists the permissions along with the name of the file's 
owner, the size (in bytes), and the date and time the file was last changed. The 
commanddisplayhasthe following format: 

-rw-rw 1 johnd group 11515 Nov 17 14:21 filel 

The permissions are shown as a sequence of ten characters on the left of the display. 
The sequence is divided into four fields. The first field (the "type" field) has a single 
character, the other fields ("user", "group", and "other", have three characters 
each. 
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- rw- rw- 

type user group other 

The characters in the fields have the following meanings: 

lnthe" type" field: 

d indicatestheitemisadirectory 

— lndicatcsthehemisanordinaryfile 

b Indicates the hem is a device special block I/O file 

c Indicatestheitemisadevkespecialcharacterl/Ofile 
In the "user", "group" , and "other" fields: 

r Indicates read permission. Read permission for a file means you may copy or 
display the file . Read permission for a directory means you may display the fi les 
in that directory. 

w Indicates write permission. Write permission for a file means you may change 
or modify the file. Write permission for a directory means you may create files 
orsubdirectorieswithinthatdirectory. 

x Indicates execute permission (for ordinary files) or search permission (for 
directories). Execute permission for a file means you may invoke the file as you 
would a program. Execute permission for a directory means you may enter that 
directory with thecd command. 

— Indicates no permission. 
For example , the permissions 

— rwxrwxrwx 

indicate an ordinary file with full read, write, and execute access for everyone (user, 
group, and other). 

The permissions 

— rw — 

indicate an ordinary file with read and write access for theuser only . 
The permissions 

drwxr— x — x 

indicate a directory with search access for everyone, read access for the user and 
group, and writeaccessforonrytheuser. 

4.3.2 Changing Permissions 

When you create a file, the XENIX system automatically assigns the following 
permissions: 
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-rw-r — r — 

Thi s means the everyone may read the file, but only the u ser may write to it . When you 
create a directory , the system assigns the permissions: 

drwxr-xr-x 

This means everyone may search and read the directory and the user may create files 
and directories within it . 

You can change the permissions of a file or a directory with the chmod (for ' 'change 
mode") command. This command requires that you tell it how to change the 
permissions of a specific file or directory. You do so by indicating which levels of 
permissions you wish to change (user "u" , group ' *g' ' , or other ' V '), how you wish 
to change ihem (add " +-" or remove "— "), and which permissions you wish to 
change (read "r", write < 'w",orexccute"x"). For example, the pattern: 

uf x 
addsexecutepermissionfortheuserandthepattern 

go-w 
removes write permission for group and other . 
The command has the form: 

chmod pattern name 

where name is one or more file or directory names. For example, to change the 

permissions of the file "receivables" from "-rw— r — r — " to "— rw 

".type: 

chmod go— r receivables 

and press the key. 

After using chmod use the I command to check the results. If you have made a 
mistake, usechmodagaintocorrectthcmistake. 

4.3.3 Changing the File Creation Mask 

The file creation mask is a special number, kept by the system, that defines the 
permissions given to every file and directory created by a user. Initially , the mask has 
the valuc022 which means every filereceivesthepermissions 

-rw— r — r — 

and every directory receivesthe permissions 

drwxr— xr— x 

You can change the mask and the initial permissions your files and directories receive, 
by using theumaskcommand. 

The umask commandhasthe form: 

umask value 

where value is a three— digit number. Thethrccdigitsrcprescntuser, group, and other 
permissions, respectively. The value of a digit defines which permission is give n: 
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digit permission 






Read, write, execute, 


and search 


1 


Read and write 




2 


Read, execute, and search 


3 


Read 




4 


Write, execute, and search 


5 


Write 




6 


Execute and search 




7 
exam 


No permissions 
pie, the command 




umask 177 





sets the file creation mask so that all files and directories initially have read and write 
permission for the user and no permissions for all others. 

4.4 Managing File Ownership 

Whenever a file is created by a user, the system automatically assigns "user 
ownership' ' of that file to that user . This allows the creator to access the file according 
to the ' 'user' ' permissions. The system also assigns a ' 'group ownership" tothe tile. 
The group ownership defines which group may access the file according to the 
"group" permissions. The group is always the same grouptowhichtheuser be longed 
when tie created the file . 

Only one user and one group may have ownership of a file at any time . (These are the 
owners displayed by the 1 command.) However, you may change the ownership of a 
file at any time with the cbown and chgrp commands. 

4.4.1 Changing User Ownership 

You can change the user ownership of a file with the cbown command. The command 
has the form: 

chown login name files 

where login name is the name of the new user acA files is the names of the files to be 
changed. For example, the command 

chown johnd projects, juhe 

changes the current owner of the file projects. June to johnd. 

The cbown command is especially useful after changing the user ID of a user (seethe 
section "Changingallser'sID" in Chapter 3). 

You must be logged inasthe super— usertousethiscommand. 

4.4.2 Changing Group Ownership 

You can change the group ownership of a file with the chgrp command. The 
command has the form: 
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chgrp group name files 

where group name is the name of a group given in the /etc/group file ami files are the 
namesof the filesyou wish tochange. Forexample, the command 

chgrp shipping projects.june 

changes the group ownership of the f&cprojects.juru to the group named shipping. 

The chgrp command is especially useful if you have changed the login group of a user 
(see the section ' 'Changing a U ser's Login Group' ' in Chapter 3) . 

4.5 System Security 

Every system, no matter what its size, should have some form of protection against 
unauthorized access to the computer, disks, and system files. The following sections 
suggestwaysforasystemmanagertoprotectthesystem. 

4.5.1 Physical Security 

You can protect the physical components of the computer , especially system disks, by 
taking these steps: 

1. Keep unessential personnel out of the work area. 

2. Orgaruzeandlockupalldisksandtapeswhennotinuse. They should not be 
stored with the computer itself . 

3. Keep disks away from magnetism, direct sunlight, and severe changes in 
temperature. 

4. Donotuseballpointpenstowritelabelsondisks. 

5 . Make backup copies of all floppy disks (see the section ' 'Copying Floppy 
Disks" inthischaptcr). 

4.5.2 Access Security 

You can protect the system against access by unauthorized individuals by taking these 
steps: 

1 . Remind usersto log out of theiraccountsbefore leaving the terminal. 

2. Discourage users from choosing passwords that are easy to guess. 
Passwords should be at least six characters long and include letters, digits, 
and punctuationmarks. 

3. Kcepthcsuper— uscrpasswordsecretfromallbutncccssary personnel. 
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4.5.3 Encrypting Text Files 



You can usually ensure both the privacy and safety of files by setting the appropriate 
permissions and maintaining system security. However, these methods cannot 
protect files from unauthorized individuals who have logged in as the super- user. 
You can protect files from an unauthorized super— user by using the crypt command 
to encrypt the file. Encryption changes the contents of the file into meaningless 
characters. The encryption is carried out by means of a key which you supply. The 
proce ss can be re versed, and the file returned to normal, by giving the same key. 

For example, to encrypt the contents of the file projects. June and store the encrypted 
file in the hleprojects. secret , type: 

crypt < projects. June >projects. secret 

and press the key. Thecommandasksforthekeywiththemessage: 

Enter key: 

Type a string of characters (it may be up to eight characters long) and press the key. 
The program encrypts the file. 

Torestore the encrypted fftcprojects.secretand display it on the screen, type: 

crypt <projects. secret 

and press the key. The command asks for the key. Type the same key you used to 
encryptthedataandpressthe key. The program displays the restored data. 

4.5.4 Protecting Special Files 

You can pre vent ordinary users from gaining direct access to the data and program files 
on the system's hard and floppy disks by protecting the system's special files. The 
XENIX special files, in the Idev directory, arc used primarily by the system to transfer 
data to and from the computer' s hard and floppy disks as well as other devices, but can 
also be used by ordinaryuserstogain direct accesstothese devices. 

Since direct access bypasses the system's normal protection scheme and allows 
ordinary users to examine and change all files in the system, it is wise to protect the 
special filestoensure system security. 

To protect the XENIX special files, log in as the super— user and use the chntod 
command to set appropriate permissions. For example, to disallow any access by 
ordinary users, set the permissions of such special files as Idevlmem, Idevfkmem, 
Idevlroot, TOiAldevlusrVo read and write access for the super-user only. Notethatyou 
must not change the permi ssions for the tty files . 

4.6 Using XENIX Accounting Features 

The XENIX system provides a set of commands that allow the system manager to 
perform * 'process accounting" . Process accounting is a simple way to keep track of 
the amount of time each user spends on the system. The process accounting 
commands keep a record of the number of processes (i.e. , programs) invoked by a 
user, how long each process lasts , and other information such as how often the process 
accessesl/O devices, and how big the process is in bytes. 
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Process accounting is helpful on systems where users are being charged for their 
access time, but it may also be used to develop a detailed record of system, command, 
and systemresourceusage. 

There are several commands which may be used to do process accounting. Of these, 
the most useful are accton and acctcom. The accton command starts and stops 
process accounting. When invoked, the command records pertinent information 
about each process invoked by logged in users to the file named lusrladmlpacct . The 
acctcom command is used to display the information. The command has several 
switches for displaying different typesof accounting information. 

4.6.1 Starting Process Accounting 

You can start process accounting whh the accton command. Process accounting can 
be started at any time. Typically, nisstartedwhenthesystemitselfisstarted. 

Before accounting can be started, the file lusrladmlpacct must be created, if it does not 
already exist. To create the file, follow these steps: 

1. Log in as the super— user. 

2. Usethecdcommandtochangethe working directory Xolusrladm. Type: 

cd Aisr/adm 

3. Usethecpcommandtocreateme/ujr/adta/paccrfile. Type: 

cp /dev/null pacct 

4. Usetheclmiodcommandtochangethefdepermissions.Type: 

chmod 644 pacct 
Usethechowncommandtochangethefik'sownership. Type: 
chown adm pacct 

5. Uscthechgrpcommandtochangethefile'sgroupownership. Type: 

chgrp adm pacct 
Once the lusrladmlpacct file is created , you may start process accounting by typing: 

accton /usr/adm/pacct 
The system immediately begins to copy process accounting information to the file. 

4.6.2 Changing Accounting Files 

Process accounting is usually conducted over a set time period, such as a day. At the 
end of each period the accounting information is saved and the accounting started 
again with a new file. This prevents disruption of the process accounting and provides 
a clean file with which to start each new accounting period 

To change the process accounting file, follow these steps: 
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Maintaining File Systems 



5.1 Introduction 



File system maintenance, an important task of the system manager, keeps the 
XENIX system running smoothly, keeps the file systems clean, and ensures 
adequate space for all users. To maintain the file systems, the system manager 
must monitor the free space in each file systen, and take corrective action 
whenever it gets too low. 

This chapter explains the file system maintenance commands. These 
commands report how much space is used, locate seldom- used files, and remove 
or repair damaged files. 



5.2 Maintaining Free Space 

The XENIX system operates best when at least 15% of the space in each file 
system is free. In any system, the amount of free space depends on the size of 
the disk containing the file system and the number of files on the disk. Since all 
disks have a fixed amount of space, it is important to carefully control the 
number of files stored on the disk. 

If a file system has less than 15% free space, system operation usually becomes 
sluggish. If no free space is available, the system stops any attempts to write to 
the file system. This means that the user's normal work on the computer 
(creating new files and expanding existing ones) stops. 

The only remedy for a file system which has less than 15% free space is to delete 
one or more files from the file system. The following sections describe strategies 
for keeping the free space available. 



5.2.1 Strategies for Maintaining Free Space 

The system manager should regularly check the amount of free space of all 
mounted file systems and remind users to keep their directories free of unused 
files. You can remind users by including a reminder in the message of the day 
file /etc/motd. (See the section "Changing the /etc/motd File" in Chapter 

8). 

If the amount of free space slips below 15%, the system manager should: 



1. Send a system-wide message asking users to remove unused files. 

2. Locate exceptionally large directories and files, and send mail to the 
owner asking him to remove unnecessary files. 

3. Locate and remove temporary files and files named core. 
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4. Clear the contents of system log flies. 



Finally, if the system is chronically short of free space, it may be necessary to 
create and mount an additional file system. 



5.2.2 Displaying Free Space 

You can find out how much free space exists in a particular file system with the 
df (for "disk free") command. This command displays the number of "blocks" 
available on thespecific file system. Ablock is512 characters (or bytes) of data. 

The df command has the form: 

df epecialfile 

where epecialfile can be the name of a XENIX special file corresponding to the 
disk drive containing the file system (see Appendix A, "XENIX Special Device 
Files"). If you do not give a special filename, then the free space of all normally 
mounted file systems is given. 

For example, to display the free space of the root file system /dev/root, type: 

df /dev/root 

and press the RETURN key. The command displays the special filename and 
the number of free blocks. You may compute the percentage of free space by 
comparing the displayed value with the total number of blocks in the file 
system. See Appendix A, "XENIX Special Device Files*" for a list of the total 
blocks. 



5.2.3 Sending a System- Wide Message 

If free space is low, you may send a message to all users on the system with the 
wall (for "write to all") command. This command copies the messages you 
type at your terminal to the terminals of all users currently logged in. 

To send a message, type: 

wall 

and press the RETURN key. Type the message, pressing the RETURN key to 
start a new line if necessary. After you have typed the message, press the 
CNTRL-D key. The command displays the message on all terminals in the 
system. To leave the wall command, press the CNTRL-D key. This removes 
the link to other terminals. 
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5.2.4 Displaying Disk Usage 

You can display the number of blocks used within a directory by using the du 
command. This command is useful for finding excessively large directories and 
files. 

The du command has the form: 

du directory 

The optional directory must be the name of a directory in a mounted file 
system. If you do not give a directory name, the command displays the number 
of blocks in the current directory. 

For example, to display the number of blocks used in the directory /uer/johnd, 

type: 

du /usr/johnd 

and press the RETURN key. The command displays the name of each file and 
directory in the /uer/johnd directory and the number of blocks used. 



5.2.5 Displaying Blocks by Owner 

You can display a list of users and the number of blocks they own by using the 
quot (for "quota") command. The command has the form: 

quot epecialfile 

The epecialfile must be the name of the special file corresponding to the disk 
drive containing the file system (see Appendix A, "XENIX Special Devices 

Files"). 

For example, to display the owners of files in the file system mounted on the 
disk drive fdev/fdl, type: 

quot /dev/fdl 

and press the RETURN key. The command displays the users who have files in 
the file system and the number of blocks in these files. 



5.2.6 Mailing a Message to a User 

If a particular user has excessively large directories or files, you may send a 
personal message to the user with the mail command. 
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To begin sending a message through the mail, type 

mail login-name 

and press the RETURN key. The login-name must be the login name of the 
recipient. To send a message, type the message, press the RETURN key, and 
then press the CNTRL-D key. If the message has more than one line, press the 
RETURN key at the end of each line. The mail command copies the message to 
the user's mailbox, where he may view it also by using the mail command. See 
the XENIX U$er'$ Guide for details. 

5.2.7 Locating Files 

You may locate all files with a specified name, size, date, owner, and/or last 
access date by using the find command. The command is useful for locating 
seldom- used and excessively large files. 

The find command has the form: 

find directory parameters 

The directory must be the name of the first directory to be searched. (It will 
also search all directories within that directory.) The parameters are special 
names and values that tell the command what to search for (seefind(C) in the 
XENIX Reference Manual for complete details). The most useful parameters 
are: 

-name file 

-atime number 

-print 

The "-name" parameter causes the command to look for the specified file . The 
"-atime" parameter causes the command to search for files which have not 
been accessed for the number of days. The "-print" parameter causes the 
command to display the locations of any files it finds. 

For example, to locate all files named core in the directory /war, type: 

find /usr -name core -print 



and press the RETURN key. The command displays the locations of all files it ^ 

finds. 
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5.2.8 Locating core and Temporary Files 

You can locate core, and temporary files with the find command. 

A core file contains a copy of a terminated program. The XENIX system 
sometimes creates such a file when a program causes an error from which it 
cannot recover. A temporary file contains data created as an intermediate step 
during execution of a program. These files may be left behind if a program 
contained an error or was prematurely stopped by the user. The name of a 
temporary file depends on the program that created it. 

In most cases, the user has no use for either c ore or temporary files and they can 
be safely removed. 

When searching for core or temporary files, it is a good idea to search for files 
which have not been accessed for a reasonable period of time. For example, to 
find all core files in the /uer directory which have not been accessed for a week, 

type: 

find /usr -name core -atime +7 -print 
and press the RETURN key. 

5.2.9 Clearing Log Files 

The XENIX system maintains a number of files, called log files, that contain 
information about system usage. When new information is generated, the 
system automatically appends this information to the end of the corresponding 
file, preserving the file's previous contents. This means the size of each file 
grows as new information is appended. Since the log files can rapidly become 
quite large, it is important to periodically clear the files by deleting their 
contents. 

You can clear a log file by typing: 

cat </dev/null > filename 

where filename is the full pathname of the log file you wish to clear. A log file 
normally receives information to be used by one and only one program, so its 
name usually refers to that program. Similarly, the format of a file depends on 
the program that uses it. See Appendix B, "XENIX Files and Directories," for 
descriptions of the log files. 

In some cases, clearing a file affects the subsequent output of the corresponding 
program. For example, clearing the file jetc/iiate forces the next backup to be 
a periodic backup (see Chapter 6, "Backing Up File Systems"). 
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5.2.10 Expanding the File System 

If free space is chronically low, it may be to your advantage to expand the 
system's storage capacity by creating and mounting a new file system. Once 
mounted, you may use this new file system for your work, or even copy user or 
system directories to it. 

A chronic shortage of space usually results from having more users on the 
system than the current hard disk can reasonably handle, or having too many 
directories or files. In either case, creating a new file system allows some of the 
users and directories to be transferred from the hard disk, freeing a significant 
amount of space on the existing file system and improving system operation. 
For details about creating and mounting file systems, see Chapter 4, "Using 
File Systems." 



5.3 File System Integrity 

Since file systems are normally stored on hard and floppy disks, occasional loss 
of data from the file system through accidental damage to the disks is not 
unusual. Such damage can be caused by conditions such as an improper system 
shutdown, hardware errors in the disk drives, or a worn out disk. 

Such damage usually affects one or two files, making them inaccessible. In very 
rare cases, the damage causes the entire file system to become inaccessible. 

The XENIX system provides a way to restore and repair a file system if it has 
been damaged. The fsck (for "file system check") command checks the 
consistency of file systems and, if necessary, repairs them. The command does 
its best to restore the information required to access the files, but it cannot 
restore the contents of a file once they are lost. The only way to restore lost 
data is to use backup files. For details about backup disks, see Chapter 6, 
"Backing Up File Systems." 



5.3.1 Repairing the File System 

You can repair a file system with the fsck command. The command has the 
form: 

fsck epccidfile 

The epecialfile must be the name of the special file corresponding to the disk 
drive containing the file system (see Appendix A, "XENIX Special Device 
Files"). 
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For example, to check the file system on the disk in the disk drive /dev/fdl, 

type 

fsck /dev/fdl 

and press the RETURN key. The program checks the file system and reports on 
its progress with the following messages. 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Pathnames 

** Phase 3 - Connectivity 

** Phase 4 - Reference Counts 

** Phase 5 - Check Free List 

If a damaged file is found during any one of these phases, the command asks if it 
should be repaired or salvaged. Type y to repair a damaged file. You should 
always allow the system to repair damaged files even if you have copies of the 
files elsewhere or intend to delete the damaged files. 

Note that the fsck command deletes any file that it considers too damaged to be 
repaired. If you suspect a file system problem and wish to try to save some of 
the damaged file or files, check other possible remedies before you invoke the 

command. 



5.3.2 Automatic File System Check 

The XENIX system sometimes requests a check of the file system when you first 
start it. This usually occurs after an improper shutdown (for example, after a 
power loss). The file system check repairs any files disrupted during the 
shutdown. For details, see the section "Cleaning the File System" in 
Chapter 2. 
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6.1 Introduction 

Afile system backup isacopy, on floppy disk, ofthc files in the root directory and other 
regularly mounted file systems. A backup allows the system manager to save a copy of 
the file system as it was at a specific time. The copy may be used laterto restore files that 
are accidentally lost or temporarily removed from the file system to save space . 

Th i s chapter explains how to create backups of the root directory and other file systems 
and how to restore files from the backups. 

6.2 Strategies for Backups 

The system manager should back up the root directory (and any other mounted file 
systems) on a regular basis. In particular, he should make daily copies of all files 
modified during the day, and make periodic (e.g. , weekly) copies of the entire root 
directory and other mounted file systems. 

The XENIX system offers two ways to back up file systems, the sysadmin program and 
the tar command. 

The sysadmin pr o gram is a formal maintenance program for systems that require a 
rigorous schedule of file system backups. Such systems usually have many users and a 
large number of files that are modified daily. The program automatically locates 
modified files, copies them to disk, and optionally produces a list of the files. 

The tar command is useful on systems with one or two users, or on any system where 
ordinaryusers wish to make personal copiesof their directories. The command letsthe 
system manager or user choose the files and directories to be copied. The command 
does not, however, automatically locate modified files. 

A typical backup schedule includes a daily backup once a day and a periodic backup 
once a week. A daily backup copies only those files modified during that day; a 
periodic backup copies all files in the file system. The appropriate schedule for a 
system depends on how heavily the system is used and how often filesare modified . In 
all cases, a periodic backup should be done at least once amonth. 

The system manager should schedule backups at times when few (if any) users are on 
the system. Thisensuresthat the most recent version of each file iscopicd correctly. 

A regular schedule of backups requires a large number of floppy disks and adequate 
storage for the disks. Daily backups should be saved at least two weeks; periodic 
backups should be saved indefinitely. Disks should be properly labeled with the date 
of the backup and the names of the files and directories contained in the backup. After a 
backuphasexpired,thediskmaybeusedtocreatenewbackups. 

6.3 Using the sysadmin Program 

The sysadmin program performs daily and periodic backups, lists backup files, and 
restores individual files from backup disks. The program presents each task as an item 
in a menu. To perform a task, simply choose the appropriate item from the menu and 
supply the required information. 
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6.3.1 Creating Backups 

To create backups with the sysadmin program, you need several formatted floppy 
disks. The exact number depends on the number of files to be copied; for example, 
some periodic backups require as many as nine disks. For details on how to format a 
floppydisk, seethesectwn"FonnattingFloppyDisks" inChapter4. 

Tocreate a backup, follow these steps: 

1. Log in asthe super— user. 

2. Type: 



and press the key. The program displays a file systemmaintenance menu . 
File System Maintenance 

Type 1 to do daily backup 

2 to do a periodic backup 

3 to get a backup listing 

4 to restore a file 

5 to quit 

3. Type 7 for a daily backup or 2 for a periodic backup. Then press the key. 
Note that if the system has never had a periodic backup, it automatically 
performsone,evenifyouhavechosenadailybackup. 

4 . Insert a floppy disk in drive 1 , wait for the drive to accept the disk (all drive 
noise should stop), and press the key . The system displays the current date 
and the date of the last backup (it display s ' 'the epoch " if there has been no 
backup). The system then begins to copy files to the floppy disks. If the disk 
runs out of space , the programdisplays the message: 

Change volumes 

5. Remove the first disk and insert a new disk. Wait for the drive to accept the 
disk, then press the key. The program continues to copy files to the new 
disk. Repeatthisstepuntiltheprogramdisplaysthemessage: 

DONE 

When doing a periodic backup, you may need to repeat the last step several times 
before the backup is complete. You should label each disk as you remove it from the 
disk drive. For example, label the first disk "Volume 1 ", the second "Volume 2", 
and soon. 

6.3.2 Getting a Backup Listing 

You can keep a record of the files you have backed up by invoking the sysadmin 
program and selecting the third item in the menu. The program copies the names of all 
files from the backup disks to the temporary file Itmpl backup. list. This listing is 
especially convenient if you keep detailed records of the files copied in each backup. 
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The backup listing is available after every daily or periodic backup. 
To get the listing, follow these steps: 

1. Log inasthe super— user. 

2. Type 

sysadmin 
and press the key. The program displays the system maintenance menu. 

3. Type.? and pressthe key. Theprogramasksyoutoreinsertthebackupdisks 
in the same order that you inserted them during the backup. 

4. Insert the first disk, wahuntilthedriveacceptsthedisk.thenpressthe key. 
The program automatically reads the filenames off the backup disk and 
places them in the list file. Whentheprogramhasreadallthenames, itasks 
forthenextdisk. 

5. Remove the first disk and insert the next. Wait forthc drive to accept the disk 
and press the key. Repeatthisstepuntilalldiskshavebeenread. 

You may produce a printed copy of the backup list by printing the list at the lineprinter. 
Type 

Ipr Amp/backup, list 

and pressthe key. After printing the file, you should remove it from the /imp directory 
with the rmcommand to save space. 

6.3.3 Restoring a Backup File 

You can restore files from the backup disks by invoking the sysadmin program and 
selecting the fourth item in the menu. You will need the complete set of backup disks 
containing the latest version of the file you wish torestore. You will also need the "full 
pathname" of the file you wish to restore. This is the name given for the file in the 
backup listing. 

To restore a file, follow these steps: 

1. Log inasthe super— user. 

2. Type 

sysadmin 
and pressthe key. The program displays the file system maintenance menu. 

3. Type 4 and press the key. Theprogramasksyoutotypethefullpathnameof 
the fileyou wish to restore . 

4. Type the pathname and press the key. The program asks for another 
pathname. 
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5. Repeat step 4 to enter another pathname or press the key to continue the 
program . If you press the key, the program asks you to insert the first disk in 
the backup set. 

6. Insert the disk, wait for the drive to accept the disk, and press the key. The 
program displays the inode numbers of the files you have given, then asks 
forthe volume numberof the backup disk containing the files. 

7. Insert the disk containing the files, type the volume number, and press the 
key. Theprogramsearchesthedisk forthe specified files. Iffound, the files 
are copied to your current directory, lfnot found, the program asks forthe 
next volume. 

8. Repeat step 7 until all fileshave been found andcopied. 

Note that the program does not restore the file's original name, but gives each file a 
unique number called an "inode" number. You can restore the file's original name 
withthemv(for << move")command. Thecommandhas the form: 

mv inode filename 

The inode must be the file's inode number. Thcfilename must be the file's original full 
pathname. Forexample, to restore the Glcio /usrfjohnd/ projects. June from224, type: 

mv 224 /usr/johnd/projects. June 

and press the key. 

6.4 Using the tar Command 

The tar command copies specified files and directories to and from floppy disks. On 
systems with one or two users, it gives the system manager a direct way to make 
backup copies ofthcfilcsmcdificd during aday. On systems with many users, it gives 
ordinary users a way tomake personal copies of their own files and directories. 

6.4.1 Copying FBes to a tar Disk 

You can copy a small number of files or directories to a floppy disk with the tar 
command. Thecommandhasthe form: 

tar cvf specialfile files 

The specialfile must be the name of the special file corresponding to the disk drive 
containing the disk to receive the files (see Appendix A) . The files are the names of the 
files or directories you wish to copy . 

To use the tar command, you need a formatted floppy disk and the names of the files 
and/or directories you wish to copy. For details about how to format a disk, see the 
section "Formatting Floppy Disks" in Chapter 4. If you give a directory name, the 
command copies all files in the directory (including subdirectories) to the disk. 

Forexample, to copy the filesa, b, and c to the disk in the disk drivc/dev/fd , type 

tar cvf /dev/fd a b c 

and press the key. 
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The floppydisks can store 400 kilobytes of information. Files larger than this can be 
tarred using the k option. This option specifies the size of the archive volume and 
prompts you when it needs a new floppydisk. For example, type 

tar cvfk /dev/fd 400 filename 

and press the key. For more information on tar, refer to the XENIX Reference tar(C) 
manual page. 

6.4.2 Restoring Files from a tar Disk 

You may also use the tar command to restore files from a disk. The command simply 
copies all files on the disk to your current directory. In this case, the command has the 
form: 

tar xvf specialfile 

The specialfile must be the name of the special file corresponding to the disk drive 
containing the tar disk. 

For example, to restore files from thedisk in thctin\c/de\'/fd, type 

tar xvf /dev/fd 

and press the key. The command copies files on the disk in the drive to the current 
directory. 

Since the tar command only copies files to the current directory, make sure you are in 
the desired directory before you invoke the command. You can change to the desired 
directory with the cd command . 
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Using Peripheral Devices 

7.1 Introduction 

One important task of the system manager is to add peripheral devices such as 
terminals, hard disks, and lineprinters to the system. Adding such devices lets more 
usersuse the system, gives extra storage space for user's files and directories, and adds 
tothesystem'sovcrallcapabilitics. 

To add a peripheral device, the system manager must make the physical connection 
between the device and the computer, thenuscthe correct system commands to enable 
the device for operation. This chapter explains how to use system commands to enable 
a device forusc. It also describeshow tomaintainthe devices once they are added. 

Note that all physical connections between a device and the system are device- 
dependent. For information about these connections, see the hardware manual 
provided with thedevice. 

7.2 Using Multiple Screens 

The simplest way to add an extra terminal to the system is to ' 'use multiple screens' ' . 
The system console, the hard— wired terminal used to start and stop the system, is 
actually three terminals in one, each sharing the same keyboard and screen but 
providing independent interaction with the system. You can switch from one terminal 
to another by holding down the key and pressing the key on the far right of the 
keyboard (in the numeric keypad). No physical connections are required . 

Although all three screens may be open at the same time, only one is active at any given 
time . When you switch the system console, the system automatically displays the new 
terminal's screen. AnyworkyoudoatmenewteixainalarTectsthatterminalonly. The 
old terminal's screen and keyboard are saved until you restore them by switching the 
system console again. 

Using multiple screens gives the user a way to access more than one user account at the 
same time. Any user may log in to an account at one terminal, then switch to the next 
terminal and log in to a different account. The user may then switch back and forth 
bet ween the three terminals as needed to do work in the desired account . 

For convenience, the three terminals are named console, ttyOJ. and tty02, 
respectively. The console is always the first terminal to be active when you start the 
system . The system enables ttyOl and tty02 for use only after you begin multi-user 
operation. 

7.3 Adding a Terminal 

You can give simultaneous access to the system for two or more users by adding extra 
terminals. Add a terminal by connecting it to an RS - 232 serial line on the system and 
enabling it with the enable command. Many different terminals work well with the 
XENIX operating system. An abbreviated list of recommended models is given in 
r<r/7ni'7ia/j(M)inthe XENIX Reference . 

Before you can add a terminal, you must know how to connect the terminal to a serial 
line on the computer. Physical connections for the terminal a»-c usually explained in the 
terminal' s hardware manual. The names of the available serial lines on the system are 
given in Appendix Aof this guide. Once a terminal has been connected, youmaythen 
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enable the terminal for use with the enable command. 
To add a terminal, follow these steps: 

1 . Using the recommended procedure in the terminal's hardware manual, 
connect the terminal to one of the RS-232 serial lines on the computer 
itself. Make sure that the terminal is compatible with the line configuration 
(fora description of the serial ports, see Appendix A). 

2. Log inasthe super-user. Type: 

# cd/dev 

# mkdev serial 

3. Use the enable command to enable the terminal. The command has the 
form: 

enable specialfile 

where specialfile is the name of the serial line to which the terminal is 
attached. This name depends on your system's configuration (see 
Appendix A). For example, the command 

enable /dcv/ttyOa 

enables the terminal connected on serial line IdevlttyOa. Likewise, to enable 
the second serial port, type: 

enable /dev/ttyOb 

4. Turn on the power to the terminal and press the/lkey several times. The 
system should display a "login:" message. When it does, you may log in 
and begin work. 

If no "login:" message appears on the screen, if random characters appear, or if the 
terminal does not respond to your attempt to log in, you may need to change the baud 
rate (or ' ' line speed " ) of the terminal to match the serial line. You can change the baud 
rate with the stty command described in the next section. 

Whenusingthe enablecommand, make sure that you wait a full minute between each 
use of the command. Failuretodosocancauseasystemcrash. 

7.4 Changing Serial Line Operation 

Whenever you enable a terminal with the enable command, the system automatically 
sets the operating characteristics of the serial line to a set of default values. Sometimes 
these values do not match the values used by the terminal, and therefore must be 
changed to allow communication between the system and the terminal. You can 
display and change the operating characteristics of a serial line with the stty (for "set 
tty") command. 

You candisplay the current operating characteristics of a serial line by typing 

stty 

at the terminal connected to that line . If it is impossible to login in at that terminal, you 
may use anotherterminaltodisplay the characteristics. Log in as the super— user at the 
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other terminal and type 

stty <specialfile 

where specialfile is the name of the device special file corresponding to the serial line 
(see Appendix A). For example, the command 

stty </dev/ttyOa 

displays the current characteristics of the serial line named IdevlttyOa . The command 
displays the baud rate, the parity scheme, and other information about the serial line. 
The meaning of this information is explained in stty (Q in the XENIX Reference . 

One common change to a serial line is changing the baud rate. This is usually done 
from a terminal connected to another serial line since changing the rate disrupts 
communication between the terminal and system. Log in as the super— user at the 
other terminal and type 

stty baud— rate <specialfile 

where baud— rate is the terminal's desired baud rate and specialfile is the name of the 
device special file corresponding to the serial line you wish to change. The baud rate 
must be in the set 50, 75, 1 10, 134, 150, 200, 300, 600, 1200, 2400, 4800, and 9600. 
For example , the command 

stty 9600 </devAry0a 

changes the baud rate of the serial line IdevlttyOa to 9600. Note that the "less than" 
symbol(<)isusedfor both displaying and settingthe serial line from another terminal. 

Another common change is changing the way the system processes input and output 
through the serial line. Such changes are usually made from the terminal connected to 
the serial line. For example, the command 

stty —tabs 

causes the system to expand tabs with spaces (used with terminals which do not expand 
tabsontheir own), andthc command 

stty echoe 

causes the system to remove a deleted character from the terminal screen when you 
back over it withthe key. 

Note that the stty command may also be used to adapt a serial line to an unusual 
terminal or to another type of serial device which requires parity generation and 
detection and special input and output processing. 

For afuUdescriptionofthiscommand, see$ffy(QintheXENIXJ?<^er«tc* . 

7.5 Setting Serial Line Baud Rate 

The changes that stty(C) makes to the baud rate of*a serial line (described in the 
preceeding section) are volatile in the sense that they disappear when the line 'closes* 
(usually when the current user logs out). To make a change that will carry over to the 
next login, follow these steps: 

1 . Log in as root (super— user) on a serial line other than the one whose speed 
you want to change. Make sure nobody is logged in on the line you want to 
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change. 

2 . disable the line you want to change. See disable(C) for instructions. 

3. Edit the file letclttys. The format of this file is described on the ttys(M) 
manual page. Find the entry corresponding to the serial line whose speed 
you want to change, then change the one character 'mode ' to reflect the new 
speed. The getty( M) page furnishes a table of corresponding speeds. 

4. enable the serial line. The speed change will be read by getty, and a login 
message will appear at thenewbaudrate on the port. 

7.6 Setting the Terminal Type 

Several XENIX utility programs (for example the visual editor, vi, and the visual shell, 
vsh), and many "screen— oriented" application programs, mustmake use of detailed 
information about your terminal. These programs communicate with the terminal 
hardware to move the cursor, highlight an area of the screen, clear the screen, and the 
like 

The standard XENIX shell sb (command interpreter) sets aside a variable, TERM, to 
refer to the name of your terminal. This variable isthen passed ontoprogramsthat you 
invoke, so your terminal type is available to them if they need it. The file letcltermcap 
(short for "terminal capabilities") is an ASCII database that describes features of over 
100 popular terminals. A list of terminals supported by XENIX, along with their 
names, maybe found in tenninals(M). 

The easiest way to set the TERM, variable is with the tset command. The tset 
command determines the name of the line you have logged in on (e.g. ttyOl), then 
reads the fite/«/c//ryry/Ktodetermmeueterminaltypeforthatline. The/erc/ny/ypefile 
supplied with a Lisa XENIX distribution looks like this: 

lisa console 

lisa ttyOl 

lisa tty02 

unknown ttyOa 
unknown ttyOb 

The file /etc/profile, which is read and executed by the shell every time you log in, 
contains the lines: 

eval 'tset — m unknown:? — m liswb:? liswb — m lisa:? lisa — h — e — s — r' 
export TERM 
export TERMCAP 

If you log in on the console, ttyOl , or tty02 (recall that these three logical devices are 
attached to the Lisa keyboard and screen), the following prompt will appear: 

TERM = (lisa) 

The name "lisa" is short for "Lisa console in black— on— white mode". At this 
prompt, you may press RETURN to indicate that this default value is suitable. In this 
case, tsetwillclearthescreen.andannouncetheterminaltypcwith: 
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Terminal type is lisa 



lfyouIoginonttyOaorttyOb,tsetwUlreadthewcmJ <, unknown"andpromplyoufora 
terminal type with: 

TERM = (unknown) 

Respond with any of the names in terminab(M), and tset will automatically set your 
TERM variable, and announce the terminal type on the screen. If your response is not 
one of the names in terminals(M), or if you type the name incorrectly, you may see: 

Terminal type unknown 

In this case, you should log out and log back in again, then supply the correct name at 
the prompt. 

You may modify both letclttytype and the tset command line in I etcl profile to suit your 
particular needs. On the other hand, you may prefer to have white letters on a black 
background, if so, at the prompt: 

TERM = (lisa) 

type: 

liswb 

and press the RETURN key. The screen will clear shift to white— on— black mode, and 
display: 

Terminal type is liswb 

If all of the users of you Lisa prefer the white -on- black mode, you may wish to 
change the word "lisa" to "liswb" each place it appears mletclttytpe . Then you will 
need only press the RETURN key at the TERM prompt . Examples are provided on the 
tset(Q manual page. 

7.7 Removing a Terminal 

From time to time it may be necessary to remove a terminal from the system, for 
example, if you wish to replace it with a serial line printer. Before you can remove a 
terminal, youmustdisablehwiththedisablecommand. 

Toremove a terminal, follow these steps: 

1. Turn offthepowerto the terminal. 

2. Log inasthe super— user at another terminal. 

3. Use the disable command to disable the terminal. The command has the 
form: 

disable specialfiU 

where specialfiU is the name of the serial line to which the terminal is 
attached. For example, the command 

disable /dev/ttyOa 

disablestheterminalconnectcdtoserialline/</^v/»vOa. 
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4. Disconnectthetenninalfromthesystem. 
The serial line previously connected to the terminal is now free to accept another 
device. 

When using the disable command, make sure that you wait a full minute between each 
useof the command. Failure todosocancauseasystemcrash. 

7.8 Adding a Second Profile Disk 

If your XENIX system was initially installed on only one Profile hard disk, you can give 
the system extra room for storing users' files and directories by adding a second Profi le 
hard disk to the system, copying the lusr directory to it, then mounting it in the lusr 
directory. Addinga second hard disk is often the only remedy for a system that has one 
hard disk and suffers from chronic lack of space. 

Before adding the new disk, you must know how toconnect it to the upper parallel pott 
of the parallel expansion card in expansion slot 1. Connecting the hard disk is 
explained in the hardware manual provided with the disk. 

To add a second hard disk, follow these steps: 

1. lnstalltheharddisk,thenstartthesystem. 

2. Turnonthepowertotheharddisk. 

3. Wait for the "ready"lightontheharddisktoglowasteadyred. 

4. Log inas the super- user(makesurenootherusersare logged in). 

5. Type: 

# cd/dev 

# mkdevpf2 

# /etc/mkfs /dev/usr 9728 1 64 

# /etc/mount /dev/usr /mm 

to mount the new hard disk in the directory /mm. Make sure that the 
directory isemptybeforeyoumountthedisk. 

6. tvps-.^.^-V Mr ^« 



to copy mecontents of the /iiirdirectorytothe new hard disk. Thisoperation 
may take several minutes. You can then use the 1c command to display the 
new contents of the disk and to make sure all files and directories have been 
copied. 



7. Type: 
cd/ 



to leave the$mir directory . 



8. Type: 



7-6 



Using Peripheral Devices 



ma — r /usr/* 

to remove all files and directories contained in the /usr directory. Before 
typing this command, make sure that you have made a copy of every file and 
directory. 

9. Type: 

/etcAimount /dev/usr 
to unmount the newdisk from ihe/mnt directory. 

10. Type: 

/etc/mount /dev/usr /usr 

to mount the new disk in the lusr directory. You may access all files and 
directories inlusr asbefore. 

Note that once the new hard disk has been added to the system, you should type the 
command 

/etc/mount /dev/usr /usr 
7.9 Adding Other Profile Disks 

Installing more Profiles requires that a parallel expansion card be installed in slot #2. 
The lower port corresponds to Idevlpf4 and the top port to IdevlpfS. Follow the 
following steps to set up pf4: 

1. Type: 

# cd/dev 

# mkdev pf4 

# /etc/mkfs /dev/pf4 9728 

2. Once the device is made, the file system will be "mounted" on thedirectory 
lu by the file letclrc , the next time the system is re— booted. You may mount 
the disk now by typing: 

# /etc/mount /dev/pf4 Ai 

Note that you may choose to mount the file system on any directory name. 
Be sure to change the corresponding command in letclrc if you mount the 
filesy stem on a different directory . 

3. You may repeat the first two steps substituting pf5 and lv for pf4 and lu 
respectively. Forexample: 

# cd /dev 

# mkdev pf5 

# /etc/mkfs /dev/pf5 9728 

# /etc/mount /dev/pf5 /v 
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7.10 Adding a Parallel Lineprinter 

You can add the Lisa dot matrix printer to the system by connecting it to the lower 
parallel port on thcparallclexpansion card inexpansion slot 1 . To enable the printer for 
operation type the following commands: 

# cd/dev 

# mkdev Ip 

7.11 Adding a Serial Line Printer 

The following procedure details the installation for the Apple Imagewnter Printer. 
The basic outline is the same for any any serial printer, but the details of the actual 
switch setting may differ. For a more detailed description of installing this printer, 
refer to the Lisa 2 Owner' s Guide , Section G. To install a different printer, check with 
the manufacturer's instructions. 

1. Obtain a (null -modem) RS-232 Cable. The Apple Imagewnter is 
suppliedwitha2-partnuil-modcmcable. Assemble it by connecting one 
end of the straight— through cable (the longer of the two) to one end of the 
short ' 'modem eliminator ' ' cable. Null modem cables from other vendors 
may well be one— piece, requiring noassembly. 

2. Plug one end of the assembled null-modem cable into the printer's serial 
interface connector (located at the lower left corner of an imagewnter). 

3 . (Specific to the Imagewnter) plug the other end of the null— modem cable 
into port Bat the Check the DIP switch settings. You will find the DIP switch 
just inside the carrier cover on the right side. Set the switches as shown here: 





Switch 


Setting 


Description 




SW1-1 


open 


American character font 




SW1-2 


open 


American character font 




SW1-3 


open 


American character font 




SW1-4 


open 


66 lines/page 




SW1-5 


open 


8 data bits 




SW1-6 


closed 


elite character pitch 




SW1-7 


open 


elite character pitch 




SW1-8 


open 


no linefeed after carriage return 




SW2-1 


closed 


9600baud 




SW2-2 


closed 


9600baud 




SW2-3 


closed 


XON/XOFFprotocol 


Log inas super— user and type the following commands: 


# 


cd /dev 






# 


mkdev sip 






# 


disable /dev/ttyOb 





This will create a special file named Idevllp, which is linked to the file 
IdevlttyOb. 
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If you have a printer other than the Apple Imagewriter, you may choose to 
modify the stty(C) modes in the file /etc/lpopen . This is a shell script that is 
used to set the appropriate modes for the serial printer. 

5. The command /etc/lpopen is normally executed by the file letclrc when the 
system is restarted. You may now issue the command: 

# /etc/lpopen > /dev/lp & 

6. Asimplewaytotestthattheprintcrisfunctioningistotype: 

# date > /dev/lp 

This should send the system date to the printer. 

7.12 Supporting Modems and Terminals 

The Lisa hardware provides serial port A with the ability to communicate to a modem . 
The XENIX Operating System software can access commonly used signals such as 
'DTR' and 'CARRIER', to modify system behavior based on the interpretation of 
thosesignals. Thisisreferredtoas''modem— control''. 

For example, if a remote terminal is logged in to the system through a modem, it is 
important for the system to automatically log out that terminal in the event that the 
phone line is disconnected. This ensures system security; the next user to log on via a 
modem will not be allowed unauthorized access to the disconnected user's account. 
The system accomplishes this by monitoring the 'CARRIER' signal (RS232pin#8). 

Many modems require that the 'DTR' signal (RS232pin#20)be asserted beforeitwill 
connect with another modem. This can also be accomplished by enabling modem 
control on a serial port . 

If modem control is to be used, it is necessary that the RS232 cable used has at least the 
following wires: 

2,3,4,5,6,7,8,20 

If in doubt , use a full 25— pin cable. This cable must be connected to serial port Aon the 
Lisa, as serial port B does hot support the modem— control signals. 

ToconfigureportAfordial— in operation: 

1. Log in as super— user and type: 

# disable /dev/ttyOa 

# cd /dev 

# mkdev modem 

Modem control will nowbeenabledon/dcv/ttyOa. 

2. Next, the file letclttys must be edited to specify the baud rate desired forthe 
serial port (see getty(M)). The most common code to use for a modem port 
is 3 , so that the line mletclttys would be: 

03tty0a 
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3. Enable logins by typing: 

# enable Vdev/ttyOa 

The enable command will edit letclttys % changing the first character on the line 
corresponding to ttyOa from to 1 . Then it will signal the operating system to start up 
logins on the port. 

7.13 Adding a Tecmar Serial Card 

The Tecmar Serial Card is a quad asynchronous interface for up to 4 RS232 terminals 
(or printers) at speeds up to 9600 baud . XENIX is configured to support the tecmar card 
in expansion slot 3 (the right most slot as viewed fromthebackof the machine). 

The following procedure will enable accesstothese ports. 

1 . Install the tecmar card in expansion slot #3 (refer to the Lisa 2 Owner's 
Guide , Section G appendices for details). 

2. Loginassuper-userandtypethefoUowingcommands: 

# cd /dev 

# mkdev tecmar 

3. Edit the file letclttys using one ofthe text editors. Add the following lines to 
the end of the file. 

02tty20 
02tty21 
02tty22 
02tty23 

4. Exit the editor and type the following for each terminal to be used as a login 
terminal: 

# enable /dev/tty20 

# enable /devAty21 

# enable /dev/tty22 

# enable /dev/tty23 

Remember to wait a full minute between invocations ofthe enable command . Failure 
to do so may cause a system crash. 
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Solving System Problems 

8.1 Introduction 

This chapter explains how to solve problems that affect the operation of the system. 
The problems range in complexity from how to fix a nonechoing terminal to how to 
restore lost system files. 

8.2 Restoring a Nonechoing Terminal 

A nonechoing terminal is any terminal that does not display characters typed at the 
keyboard . This abnormal operation can occur whenever a program stops prematurely 
as aresuh of an error ortheuser pressing the key. The user may also unwittingly press 
CTRL-Q, which has the effect of a nonechoing terminal. CTRL-Q is equivalent to a 
NO SCROLL key. 

To restore the terminal to normal operation, follow these steps: 

1 . Press the key. This cancels the effect of NO SCROLL (i. e. ) in case this was 
the problem. 

2. Pressthe key. The system may display an error message. If it does, ignore 
the message. 

3. Type: 

stty sane 

and press the key. The terminal does not display what you type, so type 
carefully. 

After pressing the key, the terminal should be restored and you may continue your 
work. 

8.3 Freeing a Jammed Lineprinter 

Lineprinter errors, such as running out of paper, can cause the Ipd program to "lock 
up" the printing queue, preventing the current file and any other files in the queue from 
being printed . The Ipd program is the " lineprinter daemon* ' , the program which does 
the actual printing forthe system print commandlpr. 

To free a jammed lineprinter, follow these steps: 

1. Log in as the super— user. 

2. Type 

ps —a 

to find the process identification number (PID) of the Ipd program. (The PID 
is in the first column of the display . ) The command display should look like 
this: 
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PID TTY TIME COMMAND 

34 01 0:08 sh 
135 01 0:25 lpd 



3. Type 

kill PID 

and press the key. The PID is the process identification number of the the 
program. 

4. Locateandfixtheen-ormatcausedthelmeprintertobecomejammed. 

5. Type 

cd /usr/spool/lpd 

to change to the lineprinter spool directory. This directory temporarily 
holdsthefilestobeprinted. 

6. Type 

rm ~f lock 

to remove the lineprinter spool' s lock file . This frees the queue and allows 
printingtocontinue. l < 

After freeing the lineprinter, you must issue another Ipr command to start printing. 

8.4 Stopping a Runaway Process 

A runaway process is a program that cannot be stopped from the terminal at which it 
was invoked. This occurs whenever an error in the program ' 'locksup' ' the terminal, 
that is , prevents anything you type from reaching the system. 

To stop a runaway process, follow these steps: 

1. Go to a terminal that is not locked up. 

2. Log in as the super— user. 

3 Type 

ps —a 

and press the key. The system displays all current processes and their ^ 

process identification numbers (PIDs). Find the PID of the runaway V 

program. 

4 Type: 

kill PID 
and press the key. The PID is the process identification number of the 
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runaway program. The program should stop in a few seconds. If the 
process does not stop, type 

kill -9 P1D 

and press the key. 

The last step is sure to stop the process, but may leave temporary files or a nonechoing 
terminal. To restore the terminal to normal operation, follow the instructions in the 
section "Restoring aNonechoing Terminal" in this chapter. 

8.5 Replacing a Forgotten Password 

The XENIX operating sy stem doesnotprovideawaytodeciphcranexisting password. 
If a user forgets his password, the system manager must change the password to a new 
one. To change an ordinary user password, follow the instructions in the section 
"Changing a User*s Password" in Chapter 3. Restoring a forgotten super— user 
password requires booting XENIX from the Boot floppydisk. Refer to the section titled 
' 'Starting XENIX From a Floppy Disk* ' in the XENIX Installation Guide . Once you 
have the booted the system from the Boot floppydisk you are in System Maintenance 
mode (i. e . you are super — user). At the pound sign prompt (#) you can now type 

# mount /dev/root /mnt 

# cp /mnt/etc/passwd /mnt/etc/passwd.old 

# cp /etc/passwd /mnt/etc 

# /etc/haltsys 

Press the key after each line, and wait for the prompt before typing the next line. This 
will copy the forgotten password into passwd. old and the blank passwd file from the 
boot floppy into the root passwd file. You can now reboot the system as described in 
the section "Copying the XENIX System Files" (the end of that section describes 
rebooting the system). Create a new super— user password as described in the section 
"Creatingthe Super— User Password" . 

8.6 Removing Hidden Files 

Ahiddenfileisanyfifewhosenamebeginswhhadot(). Youcanlistthehiddenfilesin 
a directory by typing: 

lc -a 
and pressing the key. You canremove most invisible files from a directory by typing: 

rm .[a— z|* 
and pressing the key. Remainingfilescanberemovedindividually. 

8.7 Restoring Free Space 

The system displays an ' 'out of space" message whenever the root directory has little 
or no space left to work. To restore system operation, you mu st delete one or more files 
from the root directory. To delete files, follow the steps outlined in the section 
"MaintainingFreeSpace"inChapter5. 
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8.8 Restoring Lost System Files 



If a system program or data file is accidentally modified or removed from the file ^ 

system, you can recover the file from the periodic backup disk with the sysadmin 
program. To restore the files, follow the instructions in the section "Restoring a 
BackupFile" inChapter6. 

8.9 Restoring an Inoperable System 

On very rare occasions, one or more of the critical XENIX system files may be 
accidentally modified or removed, preventing the system from operating. In such a 
case, you must reinstall the XENIX system and restore userprogram and data files from 
backupdisks. To reinstall the system, followtheinstructionsintheXENIX//i.JM//a//o/i 
Guide . To restore files from backup disks, follow the instructions in the section 
" Restoringa BackupFile" in Chaptcr6. 

8.10 Recovering From a System Crash 

A system crash is a sudden and dramatic disruption of system operation that stops all 

work on the computer. System crashes occur very rarely and are usually the result of 

hardware errors or damage to the root file system which the operating system cannot 

correct by itself. When a system crash occurs, the system usually displays a message (. 

explaining the cause of the error and then stops. This gives the system manager the 

chance to recover from the crash by correcting the error (if possible) and restarting the 

system. 

A system crash has occurred if 1) the system has displayed at the system console a 
message beginning with "panic:" and/or 2) the system refuses to process all input 
(including and keys) from the system console and all other terminals. 

Torecover from a system crash, followthcse steps: 

1. Use the error message(s) displayed on the system console to determine the 
errorthatcaused the crash, lfthere is no message, skiptostep3. 

2. Correct the error, if possible. A complete list of error messages and 
descriptions for correcting the corresponding errors is given in 
message s(M) in the XENIX Reference Manual. (Even if the problem 
Cannot be located or corrected , it is generally worthwhile to try to restart the 
system at least once by completingtheremaining steps inthisprocedure.) 

3. Press the RESET button at the back of the computer and follow the steps 
described in Chapter 2, "Starting theSystem",torestartthe system. Inthis 

case, itisnotnecessarytoturnonthepowerontothecomputerorharddisk. , 

4. If the system will not restart or crashes each time it is started, the operating 
system kernel may be inoperable and may need to be reinstalled. You can 
first try to reinstall just the "Boot" floppy. The XENIX Installation Guide 
section titled "Upgrade Notes" describes this procedure. Follow the 
directions in the sections listed. 
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Boot XENIX from the Boot Floppydisk - "Starting XENIX from a Floppy Disk" 

Use the upgrade utility - "Upgrading the File System" 

Boot the system from the hard disk — "Starting the System From the Hard Disk' 

You may now be able to boot the system from the hard disk, then restore 
damaged files. Refer to Chapter 6, "Backing UpFile Systems". 

5. If this doesn't work, follow the procedures described in the XENIX 
Installation Guide to reinstall the entire system and in Chapter 6, ' 'Backing 
UpFile Systems* ', tore store user's files. 

6. If the system cannot be started from the "Boot" disk in the distribution set 
for installation, the computer has a serious hardware malfunction. Contact 
a hardware service representative for help. 

8.11 Changing XENIX Initialization 

One common problem is how to adapt the system initialization to suit your system 
environment. This problem occurs whenever you have added new devices such as 
terminals or disk automatically enabled or mounted whenever you start normal system 
operation. You can adapt system initialization by modifying the system initialization 
files. 

The XENIX initialization files contain XENIX commands and/or data which the system 
reads at system startup or whenever a user logs in. The files typically mount file 
systems, start programs, and set home directories and terminal types. The 
initialization files are named /etc/ re , /etc/profile , and letclmotd . 

The system manager may modify these files to create any desired initial environment. 
The files are ordinary text files and may be modified using a text editor such as erf (see 
the XENIX User' s Guide ). Note, however, that the letclrc and I etel profile files contain 
XENIX commands and comments and have the command file format described in the 
chapter 4 "The Shell" inthe XENIX User's Guide . 

8.11.1 Changing the letclrc File 

The letclrc file contains XENIX system initialization commands. The system executes 
the commands at system startup. The commands display a startup message, start 
various system daemons, and mount file systems. You candisplay the contents of the 
file with the more command . Type 

more /etc/rc 

and press the key. 

You may change the contents of the file so that the system executes any set of 
commands you wish. For example, if you want the system to automatically mount a 
new file system, simply append the appropriate mount command in the file. The 
system will execute the command on each startup. 

To append a command to the file , follow these general steps: 
1. Log inasthe super— user. 
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2. lnvokeatexteditorandspecifythe/«c/rcasthefiletobeedited. 

3. Locate the place in the file you wish to insert the command (e.g. , if the 
command mounts a file system, insert it with other mount ingcommands). 

4. Insert the command on a new line. Make sure you type the command 
correctly. The system will reject any incorrect command and all following 
commands when it reads the file at system startup. 

5. Exit the editor. 

No other changes to the file are required. Be careful not to delete any commands 
already in the file unless you are sure they are not needed. 

8. 11.2 Changing the .profile Files 

The .profile files contain commands that initialize the environment for each user. The 
commands in the file are executed whenever the user logs in. The file usually contains 
commands that set and export various system variables (e.g. , TERM, PATH, MAIL). 
These variables give the system information such as what terminal type is being used , 
where to look for programs the user runs, where to look for the user's mailbox, what 
keys to expect for the ' 'kill* ' and ' 'backspace' ' functions, and so on (see the chapter 
' "The Shell" in the XENIX User' sGuide). 

There isone .profile file for each user account on the system. The files are placed in the 
user's home directory when the account is created. An ordinary usermay modify his 
own .profile file or allow the system manager to make modifications. In either case, 
the file can be edited like the /«fc/rc file, using a text editor. Commandscanbe added or 
removed as desired. 



8.11.3 Changing the letclmotd File 

The message of the day file, letclmotd, contains the greeting displayed whenever a 
user logs in. Initially, this file contains the name and version number of the XENIX 
system. It can be modified to include such messages as a reminder to clean up 
directories, a notice ofthe next periodic backup, and soon. 

The letclmotd file is an ordinary text file, so you can change the message by editing the 
file with a text editor. One common change is to include a reminder to delete unused 
files in order to preserve disk space. In general, you should limit the size ofthe file to 
include nomore than a screenful of information. 
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0.1 Introduction 



A Micnet network allows communications between two or more independent 
XENIX systems. The network consists of computers connected by serial 
communication lines (that is, RS-232 ports connected by cable). Each 
computer in the network runs as an independent system but allows users to 
communicate with the other computers in the network through the mail, rep, 
and remote commands. These commands pass information such as mail, files, 
and even other commands from one computer to another. 

It is the system manager's task to build and maintain a Micnet network. The 
system manager must decide how the computers are to be connected, make the 
actual physical connections, then use the netutil program to define and start 
the network. 

This chapter explains how to plan a network and then build it with the netutil 
program. In particular, it describes 

— How to choose machine names and aliases 

— How to draw the network topology map 

— How to assign serial lines 

— How to create the Micnet files 

— How to distribute the Micnet files 

— How to test the Micnet network 



0.2 Planning a Network 

To build a Micnet network, the netutil program will require you to provide the 
names of the computers that will be in the network, a description of how the 
computers are to be connected, a list of the serial lines to be used, the names of 
the users who will use the network, and what aliases (if any) they will be known 
by. 

To keep the task as simple as possible, you should take some time to plan the 
network and make lists of the information you will be required to supply. To 
help you make these lists, the following sections suggest ways to plan a network. 



0.2.1 Choosing Machine Names 

A Micnet network requires that each computer in the network have a unique 
"machine name". A machine name helps distinguish each computer from other 
computers in the network. It is best to choose machine names as the first step in 
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planning the network. This prevents confusion later on when you build the 
network with the netutil program. 

A machine name should suggest the location of the computer or the people who 
are users on the computer; however, you may use any name you wish. The 
name must be unique and consist of letters and digits. The Micnet programs 
only use the first eight characters of each name so be sure those characters are 
unique. 

The ne tutil program saves the machine name of a computer in z/etc/eystemid 
file. One file is created for each computer. After you have built and installed 
the network, you can find out the machine name of the computer you are using 
by displaying the contents of this file. 



9.2.2 Choosing a Network Topology 

The network topology is a description of how the computers in the network are 
connected. In any Micnet network, there are two general topologies from which 
all topologies can be constructed. These are "star" and "serial". 

In a star topology, all computers are directly connected to a central computer. 
All communications pass through the central computer to the desired 
destination. 

In a serial topology, the computers form a chain, with each computer directly 
connected to no more than two others. All communications pass down the 
chain to the desired destination. 

A network may be strictly star, strictly serial, or a combination of star and 
serial topologies. The only restriction is that no network may form a ring. For 
example, you cannot close up a serial network by connecting the two computers 
at each end. 

The kind of topology you choose depends on the number of computers you have 
to connect, how quickly you want communications to proceed, and how you 
want to distribute the task of passing along communications. A star topology 
provides fast communication between computers, but requires both a large 
portion of the central computer's total operation time and a large number of 
serial lines on the central computer. A serial topology distributes the 
communication burden evenly, requiring only two serial lines per computer, 
but is slow if the chain is very long (communication between computers can 
take several minutes). Often a combination of star and serial topologies makes 
the best network. In any case, make the choice you think best. If you discover 
you have made a wrong choice, you may change the network at any time. 
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0.2.3 Drawing a Network Topology Map 

A network topology map is a sketch of the connections between computers in 
the network. You use the map to plan the number and location of the serial lines 
used to make the network. 

You can make the map while you work out the topology. Simply arrange the 
machine names of each computer in the network on paper, then mark each pair 
of computers you wish to connect with serial lines. For example, the topology 
map for three computers might look similar this: 



As you draw, make sure that there is no more than one connection between any 
two computers in the network. Furthermore, make sure that no rings are 
formed (a ring is a series of connections that form a closed circle). Multiple 
connections and rings are not permitted. 



0.2.4 Assigning Lines and Speeds 

Once you have made the topology map, you can decide which serial lines to use. 
Since every connection between computers in the network requires exactly two 
serial lines (one on each computer), you need to be very careful about assigning 
the lines. Follow these steps: 

1. Make a list of the serial lines (tty lines) available for use on each 
computer in the network. You can display a list of the serial lines on a 
computer by displaying the file /'etc / tty t. A line is available if it is not 
connected to any device such as a terminal or modem. 

2. Using the topology map, first pick a computer, then assign one and 
only one serial line to each connection shown for that computer. The 
serial lines must be from the list of available lines for that computer. 
No line may be assigned more than once. For example, if computer 
"a" has only one available serial line (ttyOl), then the topology map 
should look like this: 



a 

tty 01 



Repeat step 2 for all computers in the topology map. Make sure that 
each connection is assigned a line and that no two connections on any 
given computer have the same line. When finished, the map should 
look like this: 
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ttyOl tty02 tty03 tty04 



If a computer does not have enough available serial lines to meet its 
needs, you can make the lines available by removing devices already 
connected to them. If you cannot remove devices you must redraw 
your topology map. 

4. Using the topology map, assign a serial line transmission speed for 
each computer pair. The speed may be any in the normal range for 
XENIX serial lines (i.e., 110,300... 19200). Transmission speeds are a 
matter of preference. In general, a higher speed means a smaller 
amount of time to complete a transmission, but a greater demand on 
system's input and output capabilities. 

5. After the topology map is completely filled in, make a list of all 
computer pairs, showing their machine names, serial lines, and 
transmission speeds. You will use this list when installing the 
network. 



0.2.5 Choosing Aliases 

Once you have decided how to connect the computers in the network, you can 
choose aliases for users in the network. An alias is a simple name that 
represents both a location (computer) and an user. Aliases are used by the 
mail command to allow you to refer to specific computers and users in a 
network without giving the explicit machine and user names. Although not a 
required part of the network, aliases can make the network easier to use and 
maintain. 

There are three kinds of aliases: standard, machine, and forward. A standard 
alias is a name for a single user or a group of users. A machine alias is a name for 
a computer or an entire network (called a site). A forward alias is a temporary 
alias for a single user or group of users. A forward alias allows users who 
normally receive network communications at one computer to receive them at 
another. 

When you build a network with the netutil program, you will be asked to 
provide standard aliases only. (You can incorporate machine and forward 
aliases into the network at your leisure.) Each standard alias must have a 
unique name and a list of the login names of the users it represents. You may 
choose any name you wish as long as it consists of letters and numbers, begins 
with a letter„and does not have the same spelling as the login names. The name 
should suggest the user or group of users it represents. The login names must be 
the valid login names of users in the network. 
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To help you prepare the aliases for entry during the netutil program, follow 
these steps: 

1. Make a list of the user aliases (i.e., the aliases that refer to just one 
user) and the login names of each corresponding user. 

2. Make a separate list of the group aliases (i.e., the aliases that refer to 
two or more users) and the login names or user aliases (from the first 
list) of the corresponding users. A group alias may have any number 
of cor responding users. 

Note that there are a number of predefined group aliases. The name all is the 
predefined alias for all users in the network. The machine -names of the 
computers in the network are predefined aliases for the users on each computer. 
' Do not use these names when defining your own aliases. 



0.3 Building a Network 

You build a network with the netutil program. The program allows you to 
define the machines, users, and serial lines that make up the network. 

To build a network, you must first create the Micnet files that define the 
network, then transfer these files to each computer in the network. After each 
computer receives the files, you may start the network and use it to 
communicate between computers. 

The following sections describe how to build the network. 



0.3.1 Creating the Micnet Files 

The Micnet files are created with the install option of the netutil program. The 
install option asks for the names, aliases, and serial lines of each computer in the 
network. As you supply the information, it automatically creates the files 
needed for each computer. These files can then be transferred to the other 
computers in the network with the save and restore options of netutil. This 
means you can build the entire network from just one computer. 

To use the install option, follow these steps: 

1. Log in as the super-user. 

2. Type 

netutil 

and press the RETURN key. The program displays the network utility 
menu. The install option is the first item in the menu. 
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3. Type the number 1 and press the RETURN key. The program displays 
the following message. 

Compiling new network topology 
Overwrite existing network files? (yes/no)? 

Type y and press the RETURN key to overwrite the files. The existing 
network files must be overwritten to create the new network. The 
first time you install the network, these files contain default 
information that need not be saved. If you install the system a second 
time or expand the system, it may be wise to save a copy of these files 
before starting the install option. The files can be saved on a floppy 
disk with the save option described later in this chapter. 

Once you have typed ythe program displays the following message. 

Enter the name of each machine 

(or press RETURN to continue installation). 
Machine name: 

4. Enter a machine-name by typing the name and pressing the RETURN 
key. You may enter more than one name on a line by separating each 
with a comma or a space. After you have entered all the names, 
simply press the RETURN key to continue to the next step. The 
program displays the names you have entered and asks if you wish to 
make changes. 

5. Type y (for "yes") if you wish to enter all the names again. Otherwise, 
type n (for "no") or just press the RETURN key to move on to the next 
step. If you type n, or RETURN, the program displays the message: 

For each machine, enter the names of the machines 

to be connected with it 
Machine a: 
Connect to: 

6. Using the list of machine pairs you created when planning the 
network, enter the machine-names of the computers connected to the 
given computer. You may enter more than one name on a line by 
separating each name with a comma (,) or a space. When you have 
entered the machine-names of all computers connected to the given 
computer, press the RETURN key. The program asks for the names of 
the computers connected to the next computer. 

7. Repeat step 5 for all remaining computers. As the program asks for 
each new set of connections, it will show a list of the machine-names it 
already knows to be connected with the current computer. You need 
not enter these names. The program automatically checks for loops. 
If it finds a loop, it ignores the machine-name that creates the loop and 
asks for another. 
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Finally, when you have given the connections for all computers in the 
network, the program displays alist of the connections and asks if you 
wish to make corrections. 

8. Type y if you wish to enter the connections again. Otherwise, type n 
to move to the next step. If you type n, the program displays the 
message: 

For each machine pair, enter the tty name and tty speeds 
For the a <==> b machine pair. 
Tty on a: 

9. Using the list of serial line assignments you created when planning the 
network, type the serial line name or number (e.g., tty03 or 3) for first 
computer in the pair and press the RETURN key. The program 
displays the message: 

Tty on b: 

10. Type the serial line name for second computer in the pair and press 
the RETURN key. The program displays the message: 

Speed: 

11. Type the speed (e.g., 9600) and press the RETURN key. The program 
asks for the serial lines and transmission speed of the next pair. 

12. Repeat step 7 for all remaining machine pairs. When you have given 
serial lines and speeds for all pairs, the program displays this 
information and asks if you wish to make corrections. 

13. Type y if you wish to enter the serial lines and speeds again. 
Otherwise, type n to move to the next step. The program displays the 
message: 

Enter the names of users on each machine: 

For machine a: 
Users on a: 

14. Enter a name by typing the login name of a user on the given 
computer, then press the RETURN key. You may enter more than one 
name on a line by separating each name with a comma (,) or a space. 
When you have entered all names for the given computer, press the 
RETURN key. The program displays the names of the users on the 
computer an d asks if you wish to m alee corrections. 

15. Type y if you wish to enter the user names again. Otherwise, type n. 
If you type n, the program asks for the users on the next computer. 
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16. Repeat steps 13 and 14 for all remaining computers. When you have 
given names of users for every computer, the program asks if you wish 
to enter aliases! 

Do you wish to enter any aliases? (yes/no)? 

17. Type y if you wish to enter aliases. Otherwise, type n to complete the 
installation. If you type y, the program displays the message: 

Each alias consists of two parts, the first is the alias name, 
the second is a list of one or more of the following: 

valid user names 

previously defined aliases 

machine names 

Aliases: 

18. Using the list of aliases you created when planning the network, type 
the name of an alias and press the RETURN key. The program 
displays the message: 

Users/Aliases: 

19. If the alias is to name a single user, type the login name of that user 
and press the RETURN key. The program asks for another alias. 

If, on the other hand, the alias is to name several users, type the login 
names of the users, OR if one or more of the users to be named by the 
alias are already named by other aliases, type the aliases instead of the 
login names, OR if all the users on one computer are to be named by 
the alias, type the machine-name instead of the login names. In any 
case, make sure that each item typed on the line is separated from the 
next by a comma (,) or a space. If there are more items than can fit on 
the line, type a comma after the last item on that line and press the 
RETURN key. You can then continue on the next line. After all names 
and aliases have been typed, press the RETURN key. The program 
asks for another alias. 

20. Repeat steps 17 and 18 for all remaining user aliases in your list. 
When you have given all aliases, press the RETURN key. The program 
displays a list of all aliases and their users and asks if you wish to make 
corrections. 

21. Type y if you wish to enter all aliases again. Otherwise, type n to 
complete the installation. 

Once you direct netutil to complete the installation, it copies the information 
you have supplied to the network files, displaying the name of each file as it is 
updated. Once the files are updated, you may use the save option to copy the 
Micnet files to floppy disk. 
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0.3.2 Saving the Micnet Files 

You can save copies of the Micnet files on floppy disk with the save option of the 
netutil program. Saving the files allows you to transfer them to the other 
computers in the network. Before you can save the files, you need to format a 
floppy disk (see the section "Formatting Floppy Disks" in Chapter 4). 

To save the files, follow these steps: 

1. Log in as the super-user. 

2. Type 

netutil 

and press the RETURN key. The program displays the network utility 
menu. 

3. Insert a blank, formatted floppy disk into disk drive 1. Wait for the 
drive to accept the disk. 

4. Type the number 2 and press the RETURN key. The program copies 
the Micnet files to the floppy disk. 

5. Remove the floppy disk from the drive. Using a soft tip marker (do 
not use ball point pen), label the disk "Micnet disk". 

As soon as all files have been copied, you can transfer them to all computers in 
the network. 

9.3.3 Restoring Micnet Files 

The last step in building a Micnet network is to copy the Micnet files from the 
Micnet disk to all computers in the network. Do this with the restore option of 
the ne t util program. For each computer in the network, follow these steps: 

1. Log in as the super-user. 

2. Insert the micnet disk into disk drive 1 and wait for th edrive to accept 
the disk. 

3. Type: 

netutil 

and press the RETURN key. The program displays the network utility 
menu. 
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4. Type the number S and press the RETURN key. The program begins 
to copy the network files to the appropriate directories. It displays 
the name of each file as it copies it. Finally, it displays the message: 

Enter the name of this machine: 

5. Type the machine name of the computer you are at and press the 
RETURN key. The program copies this name to the new 
I etc/ tyttemid file for the computer. If necessary, it also disables the 
serial lines to be used on the computer, preparing them for use with 
the network. 

When the files have been copied, you may start the network with the start 
option. 



9.4 Starting the Network 

Once the Micnet files have been transferred to each computer of the network, 
you can start the network with the start option of the netutil program. The 
start option starts the Micnet programs which perform the tasks needed to 
communicate between the computers in the network. 

To start the network, follow these steps for each computer in the network: 

1. Log in as the super-user. 

2. Type: 

/etc/netutil 

and press the RETURN key. The system displays the network utility 
menu. 

3. Type 4 and press the RETURN key. The program searches for the 
/ etc/ systemid bit. If it finds the file, it starts the network. If not, it 
asks you to enter the machine-name of the computer and then creates 
the file. The program also asks if you wish to log errors and 
transmissions. In general, these are not required except when 
checking or testing the network. When starting the netweork for the 
first time, type n to each question and press the RETURN key. 

Once the network has started, you may move to the next computer and start 
the network there. 

Note that, for convenience, you can let each computer start the network 
automatically whenever the system itself is started. Simply include the 
command 
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/usr/lib/mail/daemon.mn 



in the system initialization file fete/re of each computer. To add this 
command, use a text editor as described in the section "Changing the /etc/rc 
File" in Chapter 7. 

9.5 Testing a Micnet Network 

After you have started a network for the first time, you should test the network 
to see that it is properly installed. In particular, you must determine whether 
or not each computer is connected to the network. 

To test the network, you will need to know how to use the mail command (see 
the section "Mail" in the XENIX Ueer'e Guide). The following sections explain 
how to test the network and how to correct the network if problems are 
discovered. 



0.5.1 Checking the Network Connections 

You can make sure that all computers are connected to the network by mailing 
a short message to all (the alias for all users in the network) with the mail 
command. Follow these steps: 

1. Choose a computer. 

2. Log in as the super-user. 

3. Use the mail command (see the XENIX Ueer'$ Guide) and the all alias 
to mail the message: 

Micnet test 

to all users in the network. 

4. Check the mailboxes of each user in the network to see if the message 
was received. To check the mailboxes, log in as the super-user at each 
computer and use the cat command to display the contents of each 
user's mailbox. The name of each user's mailbox has the form: 

/usr/spool/mail//tf0in-name 

where login name is the user's login name. 

If all users have received the message, the network is properly installed. If the 
users at one or more computers fail to receive the message, the computers are 
not properly connected to the network. To fix the problem, you need to locate 
the computer which has failed to make a connection. The next section explains 
how to do this. 
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0.5.2 Using the LOG File to Locate a Problem 

You can locate a problem with connections by examining the LOG files on each 
computer in the network. The LOG files contain a record of the interaction 
between each pair of computers. There are two LOG files for each pair of 
computers (one file on each computer). The LOG files on any given computer 
are kept in subdirectories of the /utr/ spool/ micnet directory. Each 
subdirectory has as its name the machine-name of the other computer in the 
pair. You can examine the contents of a LOG file by typing 

cat /usr/spool/micnet/maeAtne-ncme/LOG 

and pressing the RETURN key. The machine-name must be the name of a 
computer that is paired with the computer you are at. 

Each LOG file should contain a "startup message" which lists the name of each 
computer in the pair and the serial line through which the pair is connected. It 
also shows the date and time at which the network was started. The message 
should look similar to: 

daemon. mn: running as MASTER 
Local system: a 
Remote system: b, /dev/tty02 
Tue Sep 27 22:30:35 1983 

Astartup message is added to the file each time the network starts successfully. 
If the message is not present, then one or more of the the network files and 
directories cannot be found. Make sure that you have used the restore option to 
transfer all the network files to the computer. Also, make sure that the 
I etc/ eyetemid file contains the correct machine-name for the given computer. 

Each LOG file will contain a "handshake" message if the connection between 
the computer pair has been established. The message 

first handshake complete 

is added to the file on a successful connection. If the message is not present, 
make sure that the network has been started on the other computer in the pair. 
The network must be started on both computers before any connection can be 
made. If the network is started on both computers yet no handshake message 
appears, then the serial line may be improperly connected or damaged. Check 
the serial line to make sure that the cable is firmly seated and attached to the 
correct RS-232 connectors on both computers. If necessary, replace the cable 
with one known to work. 

If both the startup and handshake messages appear in the LOG file but the 
network is still not working, you can make the network log a record of the 
errors it encountered while transmitting and a record of each transmission by 
stopping and then restarting the network with the *e and -x switches of the 



9-12 



Building a Micnet Network 



nettttilstart option. 



The -e (for "errors") switch causes error messages generated by the program to 
be copied to the file. Each message lists the cause of the error and the 
subroutine which detected the error. For example, the message 

rsync: bad Probe resp: 68 

shows that the reync subroutine received a bad response (character 68 
hexadecimal) from the other computer. You may use this information to track 
down the cause of the problem. One common problem is stray information 
being passed down the serial line by electronic noise. Make sure that the serial 
line's cable is properly protected against noise, e.g., make sure it does not lie 
near any electric motor, generator, or other source of electromagnetic 
radiation. Also, make sure the cable is in good condition. 

The -x (for "transmissions") switch causes a record of normal transmissions 
between computers to be copied to the file. Each entry lists the direction, byte 
count, elasped time, and time of day of the transmission. For example, the 
entry 

rx:0c01 22:33:49 

shows that 12 characters (Oc hexadecimal) were received ( rx) at 22:38:49. The 
elasped time for the transmission was 1 second. You can use the records to see if 
messages are actually being transmitted. 

To start the network with the -e or -x switches, type y (for "yes") when the 
start option asks if you wish to log errors or transmissions. 



0.5.3 Stopping the Network 

You can stop the network with the stop option of the nettitil program. The 
option stops the Micnet programs, stopping communication between 
computers in the network. 

To stop the network, follow these steps on each computer in the network: 

1. Log in as the super-user. 

2. Type 

netutil 

and press the RETURN key. The program displays the network utility 
menu. 

3. Type 5 and press the RETURN key. The program stops the network 
programs running on the computer. 
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9.5.4 Modifying the Micnet Network 

You can modify a Micnet network at any time by changing one or more of the 
Micnet files. You can reinstall the network with the rietvtil program. For very 
small changes (for example, correcting the spelling of an alias), you can modify 
the Micnet files directly with a text editor. The files and their contents are 
described in detail in the Miscellaneous section of the XENIX Reference 
Manual. 

In general, a copy of a file should be made before making any changes. You can 
make a copy with the cp command. You can replace an old file with the 
updated file using the mv command. Once one or more files have been changed 
on one computer, the files must be transferred to the other systems in the 
network using the save and restore options. These options can only be used 
after you have stopped the network. 

Note that changes to the aliaeet file will not be incorporated into the system 
until the aliashash program is executed. This program produces the 
aliases. haeh file needed by the network to resolve aliases. See atiaehaBh(M) in 
the XENIX Reference Manual for a description of this command. 
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XENIX Special Device Ffles 



A.l Introduction 



This appendix contains information needed to create file systems and add terminals to 
the XENIX system. For a full description of the special files mentioned here, see the 
XENIX Reference Maraud . 

A.2 File System Requirements 

Many of the file system maintenance tasks described in this guide require the use of 
special filenames, block sizes, and gap and block numbers. The following sections 
describe each indetail. 

A.3 Special Filenames 

A special filename is the name of the device special block or character I/O file 
correspondingtoaperipheraldevice, such as a hard or floppy disk drive. These names 
are required in such commands as mkfs, mount, and df to specify the device 
containing the file system to be created, mounted, or searched. The following table 
lists the special filenames and corresponding devices that you may use for the Apple 
Lisa. 



Block I/O 
SpecialFflename Disk Drive 


/dev/fd 


Floppy Drive 


/dev/nfd 


No— eject Floppy Drive 


/dcv/pfO 
/dev/root 


Profile Disk Drivel 


/dev/pf2 
/dev/usr 


Profile Disk Drive 2 



A.4 Block Sizes 

The block size of a disk is the number of blocks of storage space available on the disk, 
where a block is 5 1 2 bytes of storage. The mkfs, df , and quot commands use block 
size when creating or reporting the status of a file system . The following table lists the 
blocksizesofthediskstypicallyusedwiththe Apple Lisa. 
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Dbk 


BlockSize 


1st Profile hard disk 


7744 


lOMBharddisk 


16456 


2nd Profile hard disk 


9728 


Diskware floppy disk 


800 



Note that some of the blocks on the disks are reserved for system use and cannot be 
accessedbyuserprograms. 

A.5 Gap and Block Numbers 

The gap and block numbers are used by the mkfs command to describe how the blocks 
are to be arranged on a disk . The following table lists the gap and block numbers for the 
hard and floppy diskstypicalh/used with the Apple Lisa. 

Disks Gap Blocks 

Profile Hard Disk 1 64 

Diskware Floppy Disk 2 16 

A.6 Terminal and Network Requirements 

The enable and disable commands used to add and remove serial lines from a system 
and the install option of the netutil pi ugrau iusedtobuildanetwork require the namesof 
the serial lines through which a terminal or network is to be connected. The following 
table lists the names of serial lines available on the Apple Lisa, the location of each line 
as you face the back of the computer, and the serial line type according totheRS— 232 
conventions. 

Serial Line Name Location Type 

ttyOa Left serial port DTE 

ttyOb Right serial port DTE 

The character I/O files corresponding to these serial lines can be found in the Idev 
directory. Note that the files Idevlconsole, IdevlttyOl, and IdevltttfZ represent 
"hardwired^devicesand are notavailablcfor connection totenninals. 

When using the tt/)b and tt/)a serial lines to build a Micnet network, make sure that 
you use a ' 'reverse line" or ' 'null—modem ' * cable to connect one line to another. A 
reverse line cable connects pin 2 on the first computer's serial port to pin 3 on the 
second computer's port, pin3 on the first to pin 2 on the second, and pin 7 on the first to 
pin 7 on the second. 
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XENIX Directories 

B.l Introduction 

This appendix lists the most frequently used files and directories in the XENIX system. 
Many of these files and directories are required for proper XENIX operation and must 
not be removed or modified. The following sections briefly describe each directory. 

B.2 The Root Directory 

The root directory (/)contains the following system directories: 

/bin XENIX command directory 

/dev Device special directory 

/etc Additional program and data file directory 

/fd Floppy drive 1 directory (reserved for mounted file 

system) 
/nfd No— eject floppy drive directory (reserved for 

mounted file system) 
/lib C program library directory 
/mnt Mount directory (reserved for mounted file systems) 
/tmp Temporary directory (reserved for temporary files 

created by programs) 
/usr Userhomedirectories 

All directories are required for system operation. 

The root directory also contains a few ordinary files. Of these files, the most notable is 
thcXEMXfilcwhichcontainstheXENIX kernel image. 

B.3 The /bin Directory 

The I bin directory contains the most common XENIX commands, that is, the 
commands likely tobeusedbyanyoneon the system. The following is a list of a few of 
the commands. 



basenameecho 


rm sync 




cp 


expr sh 


tar 


date 


fsck sleep 


restor 


dump 


mv stty 


f 


dumpdir 


passwd su 





Thesecommandsandallothersinthedirectoryarerequired. 

B.4 The I dev Directory 

The /dev directory contains special device files which control access to peripheral 
devices. All files in this directory are required and must not be removed. The 
following isa list of the files. 
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/dev/console System console 

/dev/fd Floppy drive 

/dev/nfd Floppy drive (no— eject) 

/dcv/pfO Hard disk 

/dev/lp Lineprinter 

/dev/memPhysical memory 

/dev/null Null device (used to redirect unwanted output) 

/dcv/rXX Unbuffered interface to corresponding device name 

/dev/root Root file structure 

/dev/swapSwap area 

/dev/ttyXX Terminals 

/dev/tty The terminal you are using 

/dev/ttyOl Screen device 

/dev/tty02 Screen device 

/dev/ttyOa Built— in serial port 

/dev/ttyOb Built— in serial port 



B.5 The /etc Directory 

The /etc directory contains miscellaneous system program and data files. All files are 
required, but many may be modified: 

The following program and data files must not be removed or modified. 

/etc/mtab Mounted device table 
/etc/mount For mounting a file structure 

/etc/mkfs For creating a file structure 
/etc/init First process after boot 

The following data filesmaybemodified, if desired. Nofilemayberemoved. 

/etc/passwd Password file 

/etc/rc Bootup shell script 

/etc/ttys Terminal set up 

/etc/termcap Terminal capability map 

/etc/motd Message of the day 

The /etc/default directory contains files which set the default conditions for the 
command of the same name as the file. The present file contents are listed below. 
These may be modified, ifdesired. Donotremoveanyfile. 
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cron 


CRONLOG=NO 


dump 


tape = /dcv/rfdl 




disk = /dev/rroot 


dumpdir 


archive = /dev/rfdl 


lpd 


BANNERS = 1 


micnet 


executeali 


mkuscr 


home = Aisr 




shell = /bin/sh 


passwd 


MINWEEKS = 




MAXWEEKS = 999 




M1NLENGTH = 


rest or 


archive = /dev/rfdl 


su 


# SULOG = /usr/adm/sulog 




# CONSOLE = /dev/console 



B.6 The /lib Directory 

The /lib directory contains runtime library files for C and other language programs. 
The directory is required. 

B.7 The Intra Directory 

The Imnt directory is an empty directory reserved for mounting removable file 
systems. 

B.8 The Itmp Directory 

The Imp directory contains temporary files created by XENIX programs. The files are 
normally present when the corresponding program is running, but may also be left in 
the directory if the pr ogr am is prematurely stopped. You may remove any temporary 
file that does not belong toarunningprogram- 

B.9 The lusr Directory 

The usr directory contains the home directories of all users on the system. It also 
contains several other directories which provide additional XENIX commands and 
data files. 

The lusrlbin directory contains more XENIX commands. These commands are less 
frequently used or considered nonessential to XENIX system operation. 

The lusrt include directory containsheader files for compilingCprograms. 

The lusrllib directory contains more libraries and data files used by various XENIX 
commands. 

The lusr I spool directory contains various directories for storing files to be printed, 
mailed , or pa ssed through networks. 



B-3 



XENIX Operations Guide 



The lusrltmp directory contains more temporary files. 

The lusrladm directory contains data files associated with system administration and 
accounting. In particular, the lusrladmlmessages file contains a record of all error 
messages sent to the system console. This file is especially useful for locating 
hardware problems. For example, an unusual number of disk errors on a drive 
indicates a defective or misaligned drive. Since messages in the file can accumulate 
rapidly , the file must be deleted periodically . 

B.10 Log Files 

A variety of directories contain log files that grow in size during the normal course of 
system operation. Many of these files must be periodically cleared to prevent them 
from taking up valuable disk space (see "Clearing Log Files" in Chapter 5). The 
following table lists the files (by full pathname) and their contents. 



Filename 

/etc/ddate 
/usr/adm/pacct 



/xx/yy/noname 

/usr/adm/sulog 

/xx/yy/noname 
/xx/yy/noname 
/xx/yy/noname 

/xx/yy/noname 



Description 

records date of each backup. 

records accounting 

information; grows rapidly 
when process accounting is 
on. 

records each use of the cron 
program; grows only if 
option is set in the 
letcldefaidtlcron file. 

records each use of the sn 
command; grows only if 
option is set in the 
/etc/default) sulog file. 

records each use of the at 
command. 

records each use of the Ipr 
command. 

records spelling errors 
found by the spdl 
command. 

records each use of the oucp 
command. 
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/usr/spool/micnet/*/LOG records transmissions 

between machine in a 
M icnet network. The * must 
be the name of a remote 
machine connected to the 
currentmachine. 

/etc/wtmp records user logins and 

logouts. 
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removal 3-11 
/bin directory contents B-1 
/dev directory 

contents B-1 

serial line 

correspondence A-2 

special file 4-9 
/etc directory contents B-2 
/etc/group file, 

modification 3-6 
/etc/motd file 

contents 8-6 

free space reminder 5-1 

modification 8-5 

modification 8-6 

modification B-2 
/etc/passwd file 

user entry 3-3 

user ID change 3-8 
/etc/password file 

modification B-2 
/etc/profile file 

modification 8-5 
/etc/rc file 

contents 8-5 

Micnet network startup 9- 

11 

modification 8-5 

modification B-2 
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/etc/systemid file 

machine name contents 9-2 
Micnet network startup 9- 
11 
/etc/termcap file 

modification B-2 
/lib directory contents B-3 
/mnt directory, mounted file 

systems 4-2 
/mnt directory, mounted file 

systems B-3 
/tmp directory contents B-3 
/usr directory contents B-3 
BACKSPACE key 1-2 
Backup system See File 

system 
Backup system 
daily backup 6-2 
description 6-1 
file restoration 
filename 

restoration 6-4 
sysadmin procedure 6-3 
sysadmin procedure 8-4 
tar procedure 6-5 
floppy disk 
labeling 6-2 
storage 6-1 
tar command 6-4 
use 6-1 
use 6-2 
frequency 6-1 
listing 

printing 6-3 
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procedure 6-2 

periodic backup 6-2 

procedure 6-2 

programs 6-1 

schedule 6-1 

tar command procedure 6-4 
Block 

arrangement on disk A-2 

defined 5-2 

number A-2 

ownership 5-3 

size A-1 
Bootstrap program, 

booting 2-1 
BREAK key 1-2 

non echoing terminal 

result 8-1 
C program 

compilation header 

files B-3 

library files B-3 
cd command, file system 

mounting check 4-3 
chmod command 

permissions change 4-6 

special file 

protection 4-9 
CNTRL-D 

normal operation entry 2-2 

super-user account 

exit 2-3 
CNTRL-H key 1-2 
CNTRL-J, nonechoing 

terminal 8-1 
CNTRL-Q key 1-2 
CNTRL-S key 1-2 



CNTRL-S, nonechoing 

terminal 8-1 
CNTRL-U key 1-2 
CNTRL- key 1-2 
Command 

/etc/ re file, 

inclusion 8-5 

location 

/bin directory B-1 
/usr/bin directory B-3 
Computer turnoff 2-3 
Computer 

Micnet network 

connection test 9-11 
machine name 
Copying 

directories to floppy 

disk 6-4 

files to floppy disk 6-4 
core file, described 5-5 
crypt command, file 

encryption 4-9 
C.TRL-Q key 

nonechoing terminal 

result 8-1 
Daily backup See File 

system 
df command 

block size A-1 

free space display 5-2 

special filename A-1 
Directories 

making copies on floppy 

disk 6-4 
Directory 

access permissions See 

Permissions 



1-2 



access permissions See 

Permissions 

block usage 5-3 

location 5-4 

modification, super-user 

precaution 2-3 

permissions See 

Permissions 

permissions See 

Permissions 

removal 3-10 
disable command 

serial line A-2 

terminal disabling 7-5 
Disk 

block number A-2 

block size A-1 

damage See File system 

free space See File .. 

system 

gap number A-2 

security 4-8 

usage 5-3 
Dot (..), hidden file 8-3 
du command 5-3 
enable command 

serial line A-2 

terminal enabling 1-2 
Encryption key 4-9 
Error message 

recordation B-4 
ESCAPE key 1-2 
Execute permission 4-5 
File system 

amount of free space 5-1 

automatic check 5-7 

backup See Backup system 



cleaning 2-2 
contents listing 4-3 
creation 4-1 
damage 

causes 5-6 

restoration 5-6 
data loss 5-6 
defined 4-1 
destruction 4-1 
display free space 5-2 
expansion 5-6 
free space 

restoration 8-3 
lack of free space 5-1 
maintaining free space 5-1 

maintenance 5-1 
mounting 

automatic 4-3 

backup See Backup 

system 

check 4-3 

initialization 

files 8-5 

procedure 4-1 

procedure 4-2 
repair 5-6 
root 4-1 
unmounting 4-1 
unmounting 4-3 
File 
access 

permissions See 

Permissions 

permissions See 

Permissions 
backup See Backup system 



1-3 



XENIX Operations Guide 



backup See File system 

core 5-5 

core file See Core file 

damage See File system 

data loss 5-6 

determining block size 5-3 

encryption 4-9 

hidden file removal 8-3 

inaccessibility 5-6 

initialization file See 

Initialization file 

initialization file See 

Initialization file 

invisible See hidden file 

removal 

location 5-4 

Log 5-5 

Log clearing 5-5 

lost file restoration See 

Backup system 

lost file restoration See 

File system 

modification, super-user 

precautions 2-3 

permissions See 

Permissions 

permissions See 

Permissions 

printing See Printing 

recovery from backup See 

Backup system 

recovery from backup See 

File system 

r emov al 

unused files 5-1 
repair See File system 



restoration See Backup 

system 

restoration See File 

System 

system See File system 

temporary 5-5 

temporary file See 

temporary file 

time of last access 5-4 

unused file removal 5-1 
Filename 

restoration 6-4 

special filename A-1 
Files 

making copies on floppy 

disk 6-4 
find command 5-4 
Floppy disk 

backup system See Backup 

system 

block number A-2 

block size A-1 
. damage See File system 

data overwrite 4-2 

file system creation 4-1 

gap number A-2 

Micnet file saving 9-9 

security 4-8 
Floppy disks 

Formatting 4-3 
Formatting floppy disks 4-3 
Free space See File system 
fsck command 5-6 
Gap number A-2 
Group 

access 3-7 

changing the ID 3-7 
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creation 3-6 

defined 3-6 

ID 3-6 

name 3-6 

permissions See 

Permissions 

permissions See 

Permissions 
haltsys command, system 

shutdown 2-4 
Hard disk 

adding a second 7-6 

block number A-2 

block size A-1 

damage See File system 

gap number A-2 

system booting 2-1 

turnoff 2-3 
Hidden file removal 8-3 
Home directory 

removal 3-10 

setting, initialization 

files 8-5 

user account 3-1 
Hyphen (-) 

permissions 4-5 
Initialization file 

/etc/motd file See 

/etc/motd file 

/etc/motd file See 

/etc/motd file 

/etc/profile See 

/etc/profile file 

/etc/rc file See /etc/rc 

file 

/etc/rc file See /etc/rc 

file 



contents 3-5 

modification 8-5 
Inode number, backup 

system 6-4 
INTERRUPT key 1-2 
Jammed linepr inter See 

Linepr inter 
Keyboard, described 1-2 
kill command 

linepr inter freeing 8-2 

runaway process 

stopping 8-3 
KILL key 1-2 
1 command 

file system mounting 

check 4-3 

permissions 

change check 4-6 
listing 4-4 
Linepr inter 

adding 7-8 

jammed linepr inter 

freeing 8-1 

lock file removal 8-2 
Lines, terminal 

connection 7-1 
LOG file 

contents 9-12 

Mienet network 
connection error 
location 9-12 
Log files 5-5 
Log in group 3-7 
Log in name 

Mienet network 
entry 9-7 

new user 3-2 
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sending mail 5-4 
Logging in, super-user 2-2 
Logging out, system 

security 4-8 
Login name 

user account 3-1 
login 

terminal display 7-2 
lpr command 8-2 
lpr program error, 

lineprinter jam 8-1 
mail command, message 5-3 
mail command 
Micnet network 
alias 9-4 
testing 9-11 
Mail 

/usr/spool directory B-3 
network See Micnet 
network 
Mailbox removal 3-11 
Message of the day file See 

/etc/motd file 
Message of the day file See 

/etc/motd file 
Message 

system wide message 5-2 
Micnet network 

/etc/systemid file 
machine name 
contents 9-2 
system startup 9-1 1 
alias 

description 9-4 
entry 9-8 
preparation 9-5 
composition 9-1 



computer 

connection test 9-11 
machine name 9-1 

connection See computer 

file 

copying to 
computers 9-9 
creation 9-5 
modification 9-14 
restoration 9-9 
saving 9-9 
transfer 9-5 

forward alias 9-4 

group alias 
creation 9-5 

handshake message 9-13 

install option 9-5 

LOG file 

connection error 
location 9-12 
contents 9-12 

machine alias 9-4 

machine name 
choice 9-1 
file entry 9-6 
saving 9-2 

modification 9-14 

netutil program 
information 
required 9-1 
install option 9-5 
network building 9-5 
restore option 9-10 
restore option 9-5 
save option 9-5 
save option 9-9 
start option 9-10 
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stop option 9-1 4 
planning 9-1 
restore option 9—10 
restore option 9-5 
save option 9-5 
save option 9-9 
serial line 

assignment 9-3 

name entry 9-7 

transmission speed 9-4 
serial topology 

description 9-2 
standard alias 9-4 
star topology 

description 9-2 
start option 9-10 
startup 

procedure 9-10 
stop option 9-14 
stopping 9-14 
testing 9-11 
topology 

map 9-3 

types 9-2 
transmission speed 

assignment 9-4 

file entry 9-7 
mkfs command 

block number A-2 
block size A-1 
file system creation 4-1 
gap number A-2 
special filename A-1 
mkuser program 
creating a user 
account 3-1 
stopping 3-2 



Mode 

types designated 2-2 
more command 8-5 
mount command 

file system mounting 4-1 

file system mounting 4-2 

special filename A-1 
mv command, filename 

restoration 6-4 
netutil program See Micnet 

network 
netutil program, install 

option A-2 
New user 3-1 
newgrp command 3-7 
Non echoing terminal See 

Terminal 
Normal operation 

entry 2-2 

system shutdown 2-3 
Number sign (#), super-user 

prompt 2-2 
Operating system See 

System 
Out of space message 8-3 
passwd command 3-4 
Password, forgotten super- 
user 

change procedure 8-3 
Password 

change procedure 3-4 

change procedure 8-3 

complexity, system access 

security 4-8 

forgotten See replacement 

new user 3-2 
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user account 3-1 
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Periodic backup See Backup 

system 
Periodic backup See File 
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character I/O file 4-5 
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fields 4-4 
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Print queue 
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Printing 
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Process stopping 8-2 
Program 

error , runaway process 

result 8-2 

start, initialization 

files 8-5 

stopping 

nonechoing terminal 
result 8-1 

termination, core file 

placement 5-5 
quot command 

block ownership 

display 5-3 
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size A-1 
rep command 9-1 
Read permission 4-5 
remote command 9-1 
rm command 8-3 
rmuser command 

limitations 3-11 
rmuser program 

stopping 3-11 

user account removal 3-10 
root directory backup 6-1 
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contents B-1 
root 

password 

see super-user's 
password 

super-user login name 2-3 

symbol (/) 4-1 
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shutdown command 2-3 
Shutdown 

command See shutdown 

command 
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procedure 2-1 
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entry 2-2 
Super-user prompt (#) 

log in 2-3 
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password 1-1 
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restricted use 1-2 
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unauthorized, file 
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multiple uses 6-1 

description 6-1 
System console 

simultaneous access 7-1 

terminal disabling 7-5 
System Crash 
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file system 
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files 8-5 
procedure 7-4 



1-10 



Time 

file access 5-4 

system shutdown 2-3 
tty line See Serial line 
umount command 4-1 
umount command 4-3 
User account 

adding 3-1 

comments 3-3 

directory removal 3-10 

file removal 3-10 

group name 3-2 

log in name 3-2 

removal 

procedure 3-10 
User 

block ownership 

display 5-3 

changing the ID 3-8 

group See Group 

ID 3-8 

log in group See Log in 

group 

new user 3-1 

password See Password 

permissions See 

Permissions 

permissions See 

Permissions 
wall command 5-2 
Write permission 4-5 
xenix file B-1 
XENIX keys, described 1-2 



1-11 



The XENIX™ 



Operating System 



User's Guide 
for the Apple Lisa 2 



The Santa Cruz Operation, Inc. 



Information in this document is subject to change without notice and 
does not represent a commitment on the part of The Santa Cruz 
Operation, Inc. and Microsoft Corporation. The software described in 
this document is furnished under a license agreement or nondisclosure 
agreement. The software may be used or copied only in accordance 
with the terms of the agreement. 



©The Santa Cruz Operation, Inc., 1984 
©Microsoft Corporation, 1983 



The Santa Cruz Operation, Inc. 

500 Chestnut Street 

P.O. Box 1900 

Santa Cruz, California 95061 

(408) 425-7222 • TWX: 910-598-4510 SCO SACZ 



UNIX is a trademark of Bell Laboratories 

XENIX is a trademark of Microsoft Corporation 

Apple, Lisa 2, and ProFile are trademarks of Apple Computer Inc. 



Release: 68-5-24-84-1.0/1.0 



Contents 



Preface 
Acknowledgments 



1 Introduction 

1.1 Overview 1 — 1 

1.2 TheXENlXSystem 1-1 

1 .3 The XENIX Working Environment 1 - 1 

1.4 Using This Manual 1-2 

1.5 NotationalConventions 1—3 



2 Demonstration 

2.1 Introduction 2-1 

2.2 Before YouLogln 2-1 

2.3 Loggingln 2-3 

2.4 TypingCommands 2-2 

2.5 MistakesinTyping 2-3 

2.6 Read- Ahead and Type -Ahead 2-4 

2.7 StrangeTerminal Behavior 2—4 

2.8 StoppingaProgram 2—5 

2.9 Logging Out 2-5 

2.10 FurtherLearning 2-5 



3 Bask Concepts 

3.1 Introduction 3-1 

3.2 FileSystems 3-3 

3.3 NamingConventions 3-4 
3.5 InputandOutput 3-10 



4 Tasks 

4. 1 Introduction 4— 1 

4.2 Gaining AccesstotheSystem 4—1 

4.3 Configuring Your Terminal 4—2 

4.4 Controlling Processes 4-3 

4.5 EditingtheCommandLine 4-4 

4.6 Getting Status Information 4—5 

4.7 Manipulating Files 4—6 

4.8 ManipulatingDirectories 4—10 



4.9 Moving inthe File System 4—13 

4.10 Finding File andDirectory Permissions 4-14 

4.11 Processinglnformation 4—17 

4.12 UsingtheLineprinter 4-22 

4.13 Communicating with Other Users 4—23 



5 VhAScreen Editor 

5.1 Introduction 5-1 

5.2 Demonstration 5-2 

5.3 BasicConcepts 5-12 

5.4 Invoking and Exiting Vi 5-16 

5.5 Vi Commands 5—18 

5.6 Ex Commands 5—32 

5.7 Start- UpFiles and Options 5-42 

5.8 RegularExpressions 5-8 

5.9 SpeedingThingsUp 5-50 

5.10 WhenToUseEx 5-50 

5.11 Limitations 5-51 

5.12 Troubleshooting 5-51 

5.13 Character Functions 5—54 



6 Mail 

6.1 Introduction 6-1 

6.2 Demonstration 6—2 

6.3 BasicConcepts 6—4 

6.4 Tasks 6-8 

6.5 Commands 6—12 

6.6 Compose Escapes 6—20 

6.7 StartupFilesandOptions 6—25 

6.8 AdvancedFeatures 6—29 

6.9 QuickReference 6—31 



7 TheShd] 

7.1 Introduction 7-1 

7.2 BasicConcepts 7—1 

7.3 RedirectinglnputandOutput 7—5 

7.4 Shell Variables 7-9 

7.5 TheShellState 7-14 

7.6 ACommand'sEnvironment 7-15 

7.7 lnvokingthe Shell 7-16 

7.8 Passing Argumentsto Shell Procedures 7—17 

7.9 Controlling The Flow of Control 7-18 

7.10 SpccialShellCommands 7-29 



7.11 Creation and Organization of Shell Procedures 7—30 

7.12 MoreAboutExecutionFlags 7—32 

7.13 Supporting Commands and Features 7—32 

7.14 Effective and Efficient Shell Programming 7—39 

7.15 ShellProcedureExamples 7-42 

7.16 ShellGrammar 7-51 



8 BC:ACalculator 

8.1 Introduction 8-1 

8.2 Demonstration 8-1 

8.3 Tasks 8-4 

8.4 Language Reference 8-14 



9 Building a Uucp System 

9.1 Introduction 9-1 

9.2 Uucp-SystemtoSystemFileCopy 9-1 

9.3 Uux— SystemtoSystemExecution 9-4 

9.4 Uucico-Copyln.CopyOut 9—6 

9.5 Uuxqt-UucpCommandExecution 9—10 

9.6 Uulog— UucpLoglnquiry 9—10 

9.7 Uuclean— Uucp Spool Directory Cleanup 9—10 

9.8 Security 9-11 

9.9 Installing a UucpSystem 9-11 

9.10 MaintainingtheSystem 9-16 



10 The C-Shdl 

1 0. 1 Introduction 1 0- 1 

10.2 InvokingtheC-shell 10-1 

10.3 UsingShell Variables 10-2 

10.4 UsingtheC-shellHistoryList 10-4 

10.5 Using Aliases 10-7 

10.6 Redirecting input and Output 10—8 

10.7 CreatingBackgroundandForegroundJobs 10-9 

10.8 UsingBuilt-lnCommands 10-9 

10.9 CreatingCommandScripts 10—11 

10.10 Usingthcargv Variable 10-11 

10.11 Substituting Shell Variables 10—12 

10.12 UsingExpressions 10—14 

10.13 U sing the C- shell: A sample script 10-15 

10.14 UsingOtherControlStructures 10-17 

10.15 SupplyinglnputtoCommands 10-18 

1 0. 1 6 Catching Interrupts 10-19 

10.17 UsingOtherFeatures 10-19 



10.18 Starting aLoop at a Terminal 10-20 

10.19 Using Braces with Arguments 10—21 

10.20 SubstitutingCommands 10-21 

10.21 Special Characters 10-22 



11 Using The Visual Shell 

11.1 Whatisthe Visual Shell 11-1 

11.2 Getting Started With the VisualShell 11-1 

11.3 The Visual Shell Screen 11—2 

1 1 .4 Visual ShellReference 11-6 



Appendix A Ed 

A.l Introduction A-l 

A. 2 Demonstration A-l 

A.3 BasicConcepts A-2 

A.4 Tasks A-2 

A.5 ContextandRegularExpressions A-26 

A.6 Speeding Up Editing A-39 

A.7 CuttingandPastingwiththeEditor A-43 

A. 8 Editing Scripts A-45 

A.9 Summary ofCommands and Line Numbers A— 46 



Chapter 1 
Introduction 



1.1 Overview 1 

1.2 TheXENlXSystem 1 

1.3 TheXENlXWorkingEnvironment 1 

1.4 Using ThisManual 2 



l* — 



Introduction 

1.1 Overview 

This manual introduces the XENIXrrx) system by explaining the fundamental concepts 
and software needed to use it effectively. The XENIX system is an improved and 
enhanced versionof the UNIX SYSTEM IUrrMi from Bell Laboratories. It isintended for 
use in schools, corporations, laboratories and small office environments. The system 
is well known as a productive environment for software development and has been 
u sed for many years as a text processing environment . 

1.2 The XENIX System 

The XENIX system consists of a general— purpose multiuser operating system and 
over one hundred utilities and application programs. In addition to the XENIX 
Operating System described in this manual, two other XENIX system packages are 
available: the XENIX Development System and the XENIX Text Processing System. 

1.3 The XENIX Working Environment 

The XENIX system is built around the XENIX operating system. The purpose of an 
operating system is to efficiently organize and control the resources of a computer so 
that they can be used by real people. These resources include memory, disks, 
lineprinters, terminals, and any other peripheral devices connected to the system. The 
heart of the XENIX system is a ' 'multiuser' * and ' 'multitasking' ' operating system. A 
multiuser system permits several users to use a computer simultaneously, thus 
providing lower cost in computing power per user. A multitasking system permits 
several programs to run at the same time and increases productivity because multiple 
programscanrunsimultaneouslyratherthaninsequence. 

Because UNIX (and thus XENIX) has been accepted as a standard for "high— end" 
operating systems, a great deal of software is available for this environment. In 
addition, XENIX is a bridge to the MS-DOS operating system, the most widely used 
16-bit operating system in the world. For systems that support MS-DOS, XENIX 
provides commands that let you access MS-DOS format files and disks. The XENIX 
system also includes several widely praised enhancements developed at the University 
of California at Berkeley, and a visual interface similar to otherMicrosoft productivity 
tool interfaces. 

OthercharacteristicsoftheXENIXsysteminclude: 

— A powerful command language for programming XENIX commands. 
Unlike other interactive command languages, the XENIX "shell" is a full 
programming language . 

— Simple and consistent naming convent ions. Names can be used absolutely, 
or relative to any directory in the file system. 

— Device— independent input and output: each physical device, from 
mteraaiveterminalstomainmemory, istreatedlikeafile, allowing uniform 
file and device input and output . 
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— Aset of relatedtextedhors, including a full screeneditor. 

— Flexible text processing facilities. In XENIX, commands exist to find and 
extract patterns of text from files, to compare and find differences between 
files, and to search through and compare directories. Text formatting, 
typesetting, and spelling error-detection facilities, as well as a facility for 
formatting and typesetting complex tables and equations are also available . 

— Asophisticated 4< desk~calculator , 'program. 

— Mountable and dismount able file systems that permit addition of floppy 
disks to the file system. 

— A complete set of flexible directory and file protections that allows all 
combinations of read, write, and execute access for the owner of each file or 
directory , as well as for groups of users. 

— Facilities for creating, accessing, moving, and processing files and 
directories in a simple and uniform way. 

1.4 Using This Manual 

This manual is organized as follows: 

Chapter 1: Introduction 

This chapter gives an introduction and overview of the XENIX system . 

Chapter 2: Demonstration 

This chapter gives youhands— onexpcrienceinusingthcXENIX system. 

Chapter 3: Basic Concepts 

This chapter explains the fundamental concepts that you need to understand 
before you begin to use the system. Included here are sections on the file 
system, namingconventions, commands, and input and output. 

Chapter 4: Tasks 

This chapter explains how to perform everyday tasks using appropriate XENIX 
commands. 

Chapter 5: Vi 

Thischapterexplainshowtousethescreeneditor, vi. 

Chapter 6: The Shell 

This chapter describes use of the shell command interpreter and how to write 
procedures that can be executed by the shell interpreter. 

Chapter 7: Mail 

This chapter describes the XENIX mail facility and explains how to send and 
receivemail. 
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Chapter 8: BC: A Calculator 

This chapterexplains how louse BC, a sophisticated calculator program. 

Chapter 9: Building a UUCP System 

This chapter explains how to set up system to permit communication between 
XENIX and/or U nix systems using dial— up communication lines. 

Chapter 10: The C- Shell 

This chapter describes how to use csh. It covers the syntax and function of 
C— shell commands and features, and how to create shell procedures. 

Chapter 11: UsingThe Visual Shell 

This chapter describes the use and behavior of the Visual Shell, which is a 
menu— driven XENIX shell. This chapter assumes the reader is familiar with 
some general XENIX concepts, but vsh can be used by first —time users . 

Appendix A: Ed 

This chapterexplains howtouse the editor, ed. 

This manual does not attempt to give information about installing, managing, and 
maintaining the system, nor docs it discuss document preparation, software 
development, or many of the specialized utilities available in other XENIX system 
products. These subjects are covered inthe following manuals: 

The XENIX Installation Guide 

This guide describes how to install and set up the XENIX system on your 
computer. 

The XENIX Operations Guide 

This manual is a guide to managing and maintaining the entire system. 

The XENIX Reference 

This manual is a comprehensive command reference . A concise but complete 
description of each command is available here. It includes manual pages for 
Commands(C) and M iscellaneous(M). 

The XENIX Programmer's Guide 

This manual discuses how to use the programming tools available in the XENIX 
programming environment. This manual is part of the optional XENIX 
Development System. 

The XENIX Programmer' sReference 

This manual discusses writing programs that interface to the XENIX operating 
system. It provides manual page reference sections to system calls(S), 
subroutines(CP), and file formats(F). This manual is part of the optional XENIX 
Development System. 

The XENIX Text Processing Manual 

This manual explains how to use the text processing and text formatting tools 
and includes the manual pages for text commands(CT). It is a part of the XENIX 
Text Processing System. 
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2.1 Introduction 2-1 

2.2 Before You Log In 2-1 

2.3 Logging In 2-1 

2.4 Typing Commands 2-2 

2.5 Mistakes in Typing 2-3 

2.6 Read-Ahead and Type- Ahead 2-4 

2.7 Strange Terminal Behavior 2-4 

2.8 Stopping a Program 2-4 

2.9 Logging Out 2-5 



2.1 Introduction 

This chapter contains a demonstration run designed to help you get used to the 
XENIX system, so that you can quickly start to make effective use of it. It shows 
you how to log in, how to type at your keyboard, what to do about mistakes in 
typing, how to enter commands and how to log out. 



2.2 Before You Log In 

Before you can log in to the system, your name must be added to the XENIX user 
list. At that time you will be given a login name and a password. You may have 
to add your name yourself, or someone else may be assigned this task; it all 
depends on the environment in which your system is used. In any case, see the 
XENIX Operation$ Guide and mku$er(C) for detailed information on adding 
users. 

When you are given an account on the XENIX system you will also receive a user 
name, a password, and a login directory. Once you have these, all you need is a 
terminal from which you can log in to the system. XENIX supports most 
terminals and you should have no problem getting your terminal to work with 
XENIX. Once again, see the XENIX Operations Guide for more information on 
how to configure your terminal. 



2.3 Logging In 

Normally the system is sitting idle with a "login:" prompt on the terminal 
screen. If the system displays nonsense characters when you type, then your 
terminal is probably receiving information at the wrong speed and you should 
check your terminal switches. If the switches are set correctly, push the BREAK 
or INTERRUPT key a few times. 

When you get a "login:" message, type your login name, then press RETURN; 
the system will not do anything until you do. If a password is required, you will 
be asked for it. The password that you type does not appear on the screen. This 
prevents others from viewing it. Don't forget to press RETURN after you type 
your password. 

A successful login produces a "prompt character", a single character that 
indicates the system is ready to accept commands. The prompt is usually a 
dollar sign ($) or a percent sign (%). You may also get a login message such as: 

you have mail 

telling you that another system user has sent you mail. 
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2.4 Typing Commands 

Once the prompt character appears, the system is ready to respond to 
commands typed at the terminal. Try typing 

date 

followed by RETURN. The system responds by displaying something like: 

Mon Jun 16 14:17:10 EST 1983 

Don't forget to press the RETURN key after the command, or nothing will 
happen. The RETURN key won't be mentioned again, but don't forget— it has 
to be entered at the end of each command line. On some terminals RETURN 
may be labeled "ENTER" or " CR" , but in all cases, the key performs the same 
function. 

Another command you might try is who, which lists the names of everyone 
who is logged in to XENIX. A typical display from the who command might 
look something like this: 

you console Jan 16 14:00 
joe ttyOl Jan 16 09:11 
ann tty02 Jan 16 09:33 

The time, given in the fourth column, indicates when the user logged in; tty nn is 
the system name for each user's terminal, where nn is a unique two-digit 
number. The console is the special name of the master terminal that is the 
default for most operations. 

If you make a mistake typing the command name, you will see a message on 
your screen. For example, if you type: 

whom 
the system responds with the message: 

whom: not found 
Note that case is significant in XENIX. The commands 

who 
and 

WHO 

are not the same; this differs from some operating systems, where case doesn't 
matter. 
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Now try displaying a message on your screen using the echo command. Type 

echo hello world 

The Echo command does what its name implies and echoes the rest of the 
command line to your terminal: 

hello world 

Now try this: 

echo hello world >greeting.file 

This time the echo command sends its output to anew file named greeting.file , 
instead of to your terminal. Note the use of the greater-than sign (>) to 
"redirect" the outputof the command. Now type 

lc 

to list just the name of the file, greeting.file. To look at the contents of 
greeting.file , display it by typing: 

cat greeting.file 

Here "cat" stands for concatenate. One purpose of the cat command is to 
combine the contents of several files (that is, "concatenate)" and put them in 
some new file. However, since your terminal display is treated like any other file 
in XENIX, cat is most commonly used to display the contents of files on the 
screen. Therefore the above command sends the following output to your 
terminal screen: 

hello world 

To remove greeting.file , type: 

rm greeting.file 

Note that XENIX command names are often shortened to mnemonic names. 
For example, cp is short for "copy", Is is short for "list", rm is short for 
"remove", cat is short for "concatenate", mkdir is short for "make 
directory", and chmod is short for "change mode". 

2.5 Mistakes in Typing 

If you make a mistake in typing while entering a command, there are two ways 
to edit the line, provided you have not yet pressed RETURN. Pressing the BKSP 
key causes the last character typed to be erased. Backspacing with the BKSP 
key can erase characters back to the beginning of the line, but not beyond. 
Thus, if you type badly, you can correct as you go. For example, typing 
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ddBKSPateRETURN 

is the same as 

dateRETURN 

The XENIX kill character, CNTRL-U, erases all of the characters typed so far on 
the current input line. So, if the line is irretrievably fouled up, type CNTRL-U 
and start the line over. 

If you must enter a BKSP or CNTRL-U as part of the text, precede it with a 
backslash (\), so that the character loses its special ""erase"" meaning. To 
enter a BKSP or CNTRL-U in text, type "\BKSP" or "\CNTRL-U". The system 
always prints a new line on your terminal after your CNTRL-U, even if preceded 
by a backslash. Nevertheless, the CNTRL-U will have been recorded. 

To erase a backslash, backspace twice with the BKSP key, as in "\BKSPBKSP". 
The backslash is used extensively in XENIX to indicate that the following 
character is in some way special. Note that the functions performed by BKSP 
and CNTRL-U are available on all XENIX systems; however, the keys used to 
perform these functions may vary and can be set by the user with etty(C). 



2.6 Read-Ahead and Type-Ahead 

XENIX has full read- ahead, which means that you can type as fast as you want, 
whenever you want, and XENIX will remember what you have typed. If you 
enter any text while a command is displaying text on the screen, your input 
characters appear intermixed with the output characters on the screen, but 
they are stored away and interpreted in the correct order. Therefore, you can 
type several commands (i.e., "type ahead") one after another without waiting 
for the first to finish. Note that this doesn't work when you log in; type-ahead 
does not work until after you have entered your password and the dollar sign 
($) prompt appears. 



2.7 Strange Terminal Behavior 

Occasionally, your terminal may act strangely. You can often fix such behavior 
by either turning your terminal off, then quickly turning it back on, or logging 
out and logging back in; this will reset your terminal characteristics. If logging 
out and back in doesn't work, read the description of the command »tty{C) in 
the XENIX Reference Manual for more information about setting terminal 
characteristics. 



2.8 Stopping a Program 

You can abort the execution of most programs and commands by pressing the 
INTERRUPT key (perhaps called DEL, DELETE, CNTRL-C, or RUBOUT on your 
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terminal). The BREAK key found on many terminals can also be used. Inside 
some programs, like most text editors, typing INTERRUPT stops whatever the 
program is doing without aborting the program itself. Throughout this 
manual, when we say "send an interrupt" we mean press the INTERRUPT key. 



2.9 Logging Out 

To end a session with XENIX, you must log out. This is done by typing CNTRL- 
D as the first character on a line. It is not sufficient just to turn off the terminal, 
since this does not log you out. Some programs can also be ended by typing 
CNTRL-D, so beware. 
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Basic Concepts 



3.1 Introduction 



This chapter will give you an understanding of the basic concepts you need to 
function in the XENIX environment. After reading this chapter you should 
understand how the system's files, directories, and devices are organized and 
named, how commands are entered, and how a command's input and output 
can be manipulated. This chapter begins with a discussion of files. 



3.2 Files 

The file is the fundamental unit of the XENIX file system. In XENIX there are 
really three different types of files: ordinary files (what we usually mean when 
we say "file"), directories, and special files. Each of these types of files is 
described below. 



3.2.1 Ordinary Files 

Ordinary files typically contain textual information such as documents, data, 
or program sources. Executable binary files are also of this type. An ordinary 
file is simply a named concatenation of 8-bit bytes. Whether these bytes are 
interpreted as text characters, binary instructions, or program statements is 
up to the programs that examine them. Every ordinary file has the folio-wing 
attributes: 

— A filen ame (not necessarily unique) 

— A unique system number called an inode number 

— A size in bytes 

— A time of creation 

— A time of modification 

— A time of last access 

— A set of access permissions 

Files can be protected by assigning appropriate access permissions to assure 
privacy and security. This is done by providing read-write-execute 
permissions to files so that the user can control access by the owner, by a group 
of users, and by anyone else. By default, the owner of a file is its creator. The 
owner can read the file or write to it. By default, other users can read a file 
owned by another, but not write to it. File permissions can be altered with the 
chmod command. This command is discussed in Chapter 3 of this manual. 
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3.2.2 Special Files 



Special files correspond to physical devices such as hard and floppy disks, 
lineprinters, terminals, and system memory. They are called "device special 
files" . These files are not discussed in this manual. 



3.2.3 Directory files 

Directory files are read-only files containing information about the files or 
directories that are conceptually (but not physically) contained within them. 
This information consists of the name and inode number of each file or 
directory residing within the given directory. An inode number is a unique 
number associated with any given file. All files on the system have inode 
numbers. A name/inode number pair is called a link. The Is command is used 
to examine directory files and to list the information about the files 
conceptually within the named directory. With the inode number, the Is 
command can also find other information about a file. 

The nesting of directories inside other directories is the way in which XENIX 
implements its characteristic tree-structured directory system. Directories are 
discussed further in the next section. 

Like ordinary files, directories can be protected by assigning appropriate access 
permissions to assure privacy and security. This is done by giving read-write- 
search permissions to directories so that the user can control directory access 
by the owner, by a group of users, and by anyone else. Write permission 
determines whether files can be added or removed from a directory. By default, 
the owner of a directory is its creator and the owner can read, create or remove 
files within that directory. Similarly by default, a user can read files within the 
directory of another, but not add or remove files. As with file permissions, 
directory permissions can be altered with the chmod command. Default 
permissions can be altered with the u mask command. 



3.2.4 Directory Structure 

With multiple users and multiple projects, the number of files in a file system 
can proliferate rapidly. Fortunately, as mentioned earlier, XENIX organizes all 
files into a tree-structured directory hierarchy. This tree structure should be 
thought of as a physical world in which the user can move from place to place. 
"Places" are directories. Each user of the system has his own personal 
directory. Within that directory, the user may have directories or other 
subdirectories owned and controlled only by the user. 

When you log in to XENIX, you are "in" your directory. Unless you take special 
action when you create a file, the new file is created in your working directory. 
This file is unrelated to any other file of the same name in someone else's 
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directory. 

A diagram of part of a typical user directory is shown in Figure 3-1. 
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Figure 3-1. A Typical User Directory 

In Figure 3-1, the tier directory contains each user's own personal directory. 
Notice that Mary's file named text is unrelated to Eve's. This is not important 
if all the files of interest are in Eve's directory, but if Eve and Mary work 
together, or if they work on separate but related projects, this division of files 
becomes handy indeed. For example, Mary could print Eve's text by typing: 

pr /usr/eve/text 

Similarly, Eve could find out what files Mary has by typing: 

lc /usr/mary 



3.3 File Systems 

A file system is a set of files organized in a way fashion. In XENIX, this set of files 
consists of all available resources including data files, directories, programs, 
lineprinters, and disks. Thus, the XENIX file system is a system for accessing all 
system resources. 

To logically structure the resources of the system, the XENIX file system is 
organized hierarchically in an inverted "tree structure". See Figure 3-2 for an 
illustration of a typical tree-structured file system. In this typical tree of files, 
the root of the tree is at the top and branches of the tree grow downward. 
Directories correspond to nodes in the tree; ordinary files correspond to 
"leaves". If a directory contains a downward branch to other files or 
directories, then those files and directories are "contained" in the given 
directory. It is possible to name any file in the system by starting at the root 
(where the root is at the top) and traveling down any of the branches to the 
desired file. Similarly, you can specify any file in the system, relative to any 
directory. Specification of these files depends on a knowledge of the XENIX 
naming conventions, discussed in the next section. 
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Figure 3.2. A Typical File System 

In the typical tree-structured file system of Figure 3-1, the "tree" grows 
downward. The names bin, uer, dev, doug, and ne»7all represent directories, 
and are all nodes in the tree. In XENIX the name of the root directory is given 
the one-character name, "/". The names mail, newe, text, and data all 
represent normal data files, and are all "leaves" of the tree. Note that the file 
cmd is the name of a command that can be executed. The name tty represents a 
terminal and is also represented in the tree. 



3.4 Naming Conventions 

Every single file, directory, and device in XENIX has both a filename and an 
absolute pathname. This pathname is a map of the file or directory's location in 
the system. The absolute pathname is unique to all names in the system; 
filenames are unique only within directories and need not be unique system- 
wide. This is similar to someone whose "global" name is John Albert Smith in a 
telephone directory, but who may be listed simply as John in an office phone 
list. 



3.4.1 Filenames 

A simple filename is a sequence of one to fourteen characters other than a slash 
(/). Every single file, directory, and device in the system has a filename. 
Filenames are used to uniquely identify directory contents. Thus, no two 
filenames in a directory may be the same. However, filenames in different 
directories may be identical. 

Although you can use almost any character in a filename, it is best to confine 
filenames to the alphanumeric characters and the period. Other characters, 
especially control characters, are discouraged for use in filenames. When a 
filename contains an initial period, it is "hidden", and is not displayed by the 1, 
Ic, and Is commands. The dash (-.) is used in specifying command options, and 
should be avoided when naming files. In addition, the question mark (?), the 
asterisk (*), brackets ([ and ]), and all quotation marks should neverbe used in 
filenames, since they are treated specially when entering commands. 
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3.4.2 Pathnames 



A pathname is a sequence of directory names followed by a simple filename, 
each separated from the previous name by a slash. If a pathname begins with a 
slash, it specifies a file that can be found by beginning a search at the root of the 
entire tree. Otherwise, files are found by beginning the search at the user's 
current directory (also known as the working directory). The current directory 
should be thought of as your location in the file system. Think of it as a physical 
place. When you change your current directory you are moving to some other 
directory or place in the file system. 

A pathname beginning with a slash is called a full (or absolute) pathname 
because it does not vary with regard to the user's current directory. A 
pathname not beginning with a slash is called a relative pathname, because it 
specifies a path relative to the current directory. The user may change the 
current directory at any time by using the cd command. 



3.4.3 Sample Names 

Some sample names follow: 

/ The absolute pathname of the root directory of the entire file 

system. 

/bin The directory containing most of the frequently used XENIX 

commands. 

/usr The directory containing each user's personal directory. The 

subdirectory, /uer/bin contains frequently used XENIX 
commands not in /bin. 

/dev The directory containing files corresponding to physical 

devices (e.g., terminals, lineprinters, and disks). 

/dev/console The name of the system master terminal. 

/dev/tty The name of the user's terminal. 

/lib The directory containing files used by some standard 

commands. 

/tmp This directory contains temporary scratch files. 

/usr/joe/project/A 

A typical full pathname; this one happens to be a file named A 
in the directory named project belonging to the user named 
joe. 
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bin/x A relative pathname; it names the file x in subdirectory bin of 

the current working directory. If the current directory is/, it 
names /bin/x. If the current directory is /uer/joe, it names 
/iter/ joe/ bin/x. 

filel Name of an ordinary file in the current directory. 

When he is using the XENIX system, each user resides "in" a directory called 
the current directory. All files and directories have a "parent" directory. This 
directory is the one immediately above and "contains" the given file or 
directory. The XENIX file system provides special shorthand notations for this 
directory and for the current directory: 

The shorthand name of the current directory. Thus ,/filexxx names the 
same file as filexxx, if such a file exists in the current directory. 

The shorthand name of the current directory's parent directory. The 
shorthand name ../.. refers to the directory that is two levels "above" 
the current directory 



3.4.4 Special Characters 

XENIX provides a pattern-matching facility for specifying sets of filenames that 
match particular patterns. For example, examine the problem that occurs 
when naming the parts of a large document, such as a book. Logically, it can be 
divided into many small pieces such as chapters or sections. Physically, it must 
be divided too, since the XENIX editor vi cannot handle really big files. Thus, 
you should divide a large document into several files. The points at which the 
document is divided should follow a logical order. You might have a separate 
file for each chapter: 

chapl 
chap2 



Or, if each chapter is broken into several files, you might have: 

chapl. 1 
chap 1.2 
chap 1.3 

chap2.1 
chap2.2 
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You can then tell at aglance where a particular file fits into the whole. 

There are other advantages to a systematic naming convention that are not so 
obvious. What if you want to print the whole book on the lineprinter? You 
could type 

lpr chapl.l chapl.2 chapl.3 ... 

but you will tire of this quickly and will probably even make mistakes. 
Fortunately, there is a shortcut: a sequence of names contining a common 
pattern can be specified with the use of special characters. The special 
characters discussed in this chapter are: 

* Matches zero or more characters 

[J Matches any character inside the brackets 

? Matches any single character 

For example, you can type: 

lpr chap* 

The asterisk (*), sometimes called "star" in XENIX, means "zero or more 
characters of any type", so this translates into "send all files whose names begin 
with the word "chap" to the lineprinter". 

This shorthand notation is not a unique property of the lpr command; it can be 
used in any command. Using this fact, you can list the names of the files in the 
book by typing: 

Is chap* 

This produces 

chapl.l 
chapl.2 
chapl.3 

The star is not limited to the last position in a filename; it can be used anywhere 
and can occur several times. A star by itself matches all filenames not 
containing slashes or beginning with periods, so 

cat * 

displays all files in the current directory on your terminal screen. 

The star is not the only pattern-matching feature available. Suppose you want 
to print only chapters 1 through 4, and 9. You can say 
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lpr chap[12349]* 

The brackets ([ and ]) mean "match any of the characters inside the 
brackets." A range of consecutive letters or digits can be abbreviated, so you 
can also do this with 

lpr chap[l-49]* 

(Note that this does not match forty-nine filenames, but only five.) Letters can 
also be used within brackets: "[a-z]" matches any character in the range "a" 
through "z". 

The question mark (?) matches any single character, so 

Is ? 
lists all files that have single-character names, and 

Is -1 chap?.l 

lists information about the first file of each chapter (i.e., ehapl.l, chapS.l, ...). 

If you need to turn off the special meaning of any of the special characters ( *, ?, 
and [ ... ]) enclose the entire argument in single quotation marks. For example, 
the following command will print out only files named "?" rather than all one 
character filenames: 

Is '? ' 

Pattern-matching features are discussed further in Chapter 7, "The Shell". 

3.5 Commands 

Commands are used to invoke executable programs. When you type the name 
of a command, XENIX reads the command line that you have typed, looks for a 
program with the given name, and then executes the program if it finds it. 
Command lines may also contain arguments that specify options or files that 
the program may need. The command line and command syntax are discussed 
in the next two se ctions. 

3.5.1 Command Line 

Whether you are typing commands at a terminal, or XENIX is reading 
commands from a file, XENIX always reads commands from command lines. 
The command line is a line of characters that is read by the shell command 
interpreter to determine what actions to perform. This interpreter, or "shell" 
as it is known, reads the names of commands from the command line, finds the 
executable program corresponding to the name of the command, then executes 

3-8 



Basic Concepts 



that program. When the program finishes executing, the shell resumes reading 
the command line. Thus, when you are typing at a terminal, you are editing a 
line of text called the command-line buffer that becomes a command line only 
when you press RETURN. This command-line buffer can be edited with the 
BKSP and CNTRL-U keys. Pressing RETURN causes the command-line buffer to 
be submitted to the shell as a command line. The shell reads the command line 
and executes the appropriate command. If you press INTERRUPT before you 
press RETURN, the command-line buffer is erased. Multiple commands can be 
entered on a single command line provided they are separated by a semicolon 
(;). For example, the following command line prints out the current date and 
the name of the current working directory: 

date ; pwd 

Commands can be submitted for processing in "the background" by appending 
an ampersand (&) to the command line. This mode of execution is similar to 
"batch" processing on other systems. The main advantage to placing 
commands in the background is that you can execute other commands from 
your terminal in the "foreground" while the background commands execute. 
Thus: 

du /usr >diskuse& 

determines the disk usage in the directory /««r, a fairly time-consuming 
operation, without tying up your terminal. Note that the output is placed in 
the file diekuee by redirecting output with the greater-than symbol. 
Redirection is discussed in Section 3.5.1. 



3.5.2 Syntax 

The general syntax for commands is as follows: 

cmd [ ewitchee ][ argumente] [filenamee ] 

By convention, command names are lowercase. Switches, also called options, 
are flags that select various options available when executing the command. 
They are optional and usually precede other arguments and filenames. 
Switches consist of a dash prefix (-) and an identifying letter. For example, the 
Is command's -1 switch (pronounced "minus ell" ) specifies a long directory 
listing and the command 

ls-r 

specifies a directory listing in reverse alphabetical order. In some cases, 
switches can be grouped to form a single switch argument. For example, the 
command 

Is -rl 
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is really a combination of two switches, where the -rl switch selects the option 
that lists all files in the directory in both reverse alphabetical order and with 
the long format. 

Sometimes multiple switches must be given separately, as in: 

copy -v -a source destination 

Here the -v switch specifies the "verbose" option, which reports copying as it 
happens. The -a switch tells the copy command to ask the user for 
confirmation before copying the source to the deetination. 

Other arguments can also be given, such as search strings, as in: 

grep 'string of text ' outfile 
In the above example 

'string of text' 

is a single argument and is the search string the grep command searches for in 
the file outfile. Filename is the argument that specifies the name of a file 
required by the command. 

Most commands are executable programs compiled by the G compiler or by 
some other language compiler. Some commands are executable command files 
called "shell procedures". Shell procedures are discussed in Chapter 7, "The 
Shell." 

3.6 Input and Output 

By default, XENIX assumes that terminal input comes from the terminal 
keyboard and output goes to the terminal screen. To illustrate typical 
command input and output, type: 

cat 

This command now expects input from your keyboard. As input, it accepts as 
many lines of text as you type until you press CNTRL-D as an end-of-file or end- 
of-transmission indicator . 
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For example, type: 

this is two linesRETURN 
of inputRETURN 
CNTRL-D 

When you press CNTRL-D, input ends and output begins. The cat command 
immediately outputs the two lines you typed — since output is sent to the 
terminal screen by default, that is where the two lines are sent. Thus, the 
complete session will look like this on your terminal screen: 

$ cat 

this is two lines 

of input 

this is two lines 

of input 

$ 

The flow of command input and output can be "redirected" so-that input comes 
from a file instead of from the terminal keyboard and output goes to a file or 
lineprinter, instead of to the terminal screen. In addition, "pipes" can be 
created that allow the output from one command to become the input to 
another. Redirection and pipes are discussed in the next two subsections. 



3.6.1 Redirection 

In XENIX a file can replace the terminal for either input or output. For example 

Is 
displays a list of files on your terminal screen. But if you say 

Is >filelist 

a list of your files is placed in the file fileliet (which is created if it does not exist). 
The symbol for output redirection, the greater- than sign (>), means "put the 
output from the command into the following file, rather than display it on the 
terminal screen" . As another example of output redirection, you can combine 
several files into one by capturing the output of cat in a file: 

cat f 1 f2 f3 >temp 

The output append symbol (>>) operates very much like the output 
redirection symbol, except that it means "add to the end of'. So 

cat filel file2 file3 >>temp 

means "concatenate filel, fileS, and fileS to the end of whatever is already in 
temp, instead of overwriting and destroying the existing contents". As with 
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norm al output redirection, it temp doesn't exist, it is created for you. 

In a similar way, the input redirection symbol (<)■ means "take the input for a 
program from the following file, instead of from the terminal" . Thus, you 
could make a script of editing commands and put them into a file called ecript. 
Then you could execute the commands in the script on a file by typing: 

ed file < script 

As another example, you could use ed to prepare a letter in the file letter.txt, 
then send it to several people with: 

mail adam eve mary joe < letter.txt 



3.6.2 Pipes 

One of the major innovations of the XENIX system is the concept of a "pipe". A 
pipe is simply a way to connect the Output of one command to the input of 
another, so that the two run as a sequence of commands called a pipeline. 

For example: 

sort frank.txt george.txt hank.txt 

combines the three files named frank.txt, george.txt, and hank.txt, then sorts 
the output. Suppose that you want to then find all unique words in these files 
and view the result. You could type: 

sort frank.txt george.txt hank.txt > tempi 
uniq <templ >temp2 
more temp2 
rm tempi temp2 

But this is more work than is necessary. What you want is to take the output of 
sort and connect it to the input of uniq, then take the output of uniq and 
connect it to more. You would use the following pipe: 

sort frank.txt george.txt hank.txt ] uniq | more 

The vertical bar character ( | ) is used between the sort and uniq commands to 
indicate that the output from sort, which would normally have been sent to the 
terminal, is to be redirected from the terminal to the standard input of the 
uniq command, which in turn sends its output to the more command for 
viewing. 

There are many other examples of pipes. For example 
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Is | pr -3 



formats and paginates a list of your files in three columns. The program wc 
counts the number of lines, words, and characters in its input, and who prints a 
list of users currently logged on, one per line. Thus, 

who | wc 
tells how many people are logged in, and 

Is | wc 

counts the number of files in the current directory. 

Any program that reads from the terminal keyboard can read from a pipe 
instead. Any program that displays output to the terminal screen can send 
input to a pipe. You can have as many elements in a pipeline asy ou wish. 
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Tasks 



4.1 Introduction 

This chapter explains how to perform common tasks on XENIX. The individual 
commands used to perform these tasks are discussed more thoroughly in the 
XENIX Reference Manual. 



4.2 Gaining Access to the System 

To use the XENIX system, you must first gain access to it by logging in. When 
you log in you are placed in your own personal working area. Logging in, 
changingyour password, and logging out are described below. 



4.2.1 Logging In 

Before you can log in to the system, you must be given a system "account". 
Your name must be added to the user list, and you must be given a password 
and a mailbox. 

Depending on how your system is administered, you may have to add your 
name to the user list yourself, or someone else may be assigned this task. If you 
must add your own account to the system, see the XENIX Ope rati one Guide and 
mkuser[C) in the XENIX Reference Manual tor more information. This section 
assumes your account has already been set up. 

Normally, the system sits idle and the prompt "login:" appears on the terminal 
screen. If your screen is blank, or displays nonsense characters, press the 
INTERRUPT key a few times. 

When the "login:" prompt appears, follow these steps: 



1. Type your login name and press RETURN. If you make a mistake, 
press CNTRL-U to start the line again. After you press RETURN the 
word "Password:" appears on your screen. 

2. Type your password carefully, then press RETURN. The letters do 
not appear on your screen as you type, and the cursor does not move. 
If you make a mistake, press RETURN to restart the login procedure. 

If you have typed your login name and password correctly the "prompt 
character" appears on the screen. This is usually a dollar sign($). The prompt 
tells you that the XENIX system is ready to acccept commands from the 
keyboard. 

If you make a mistake, the system displays the message: 
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Login incorrect 
login: 

If you get this message, follow the above procedure again. You must type all the 
letters of your user name and password correctly before you are given access to 
the system; XENIX does not allow you to correct your mistakes when typing 
your password. 

Depending on how your system is set up, after you log in you may see a 
"banner" that says something like "Welcome to XENIX", or an announcement 
that is of interest to all users. 



4.2.2 Logging Out 

The logout procedure is simple — all you need to do is press 

CNTRL-D 

alone on a line. In general, CNTRL-D signifies the end-of-file in XENIX, and is 
often used within programs to signal the end of input from the keyboard. In 
such cases, CNTRL-D will not log you out; it will simply terminate input to a 
particular program if you are within that program. This means that it may 
sometimes be necessary to press CNTRL-D several times before you can log 
yourself out. For example, if you are in the mail program you must press 
CNTRL-D once to exit the mail program, then again to logout. 

4.2.3 Changing Your Password 

To prevent unauthorized users from gaining access to the system, each 
authorized user must have a password. When you are first given an account on 
a XENIX system you are assigned a password by the system administrator. 
Some XENIX systems require you to change your password at regular intervals. 
Whether yours does or not, it is a good idea to change your password regularly 
to maintain system security. This section tells you how to change your 
password. 

Use the passwd command to change your password. Follow these steps: 

1. Type 

passwd 

and press RETURN. The following message appears: 

Changing password for veer. 
Old password: 
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2. Carefully type your old password. It is not displayed on the screen. If 
you make a mistake, press RETURN. The message "Sorry" appears, 
then the system prompt. Begin again with step 1. 

3. When you have typed your old password the message 

New password: 
appears. Type in your new password and press RETURN. 

4. The message 

Retype new password: 

appears. Type your new password again. If you make a mistake, press 
RETURN. The message 

Mismatch -- password unchanged 

appears, and you must begin again with step 1. When you have 
completed the procedure, the system prompt appears. 



4.3 Configuring Your Terminal 

On most systems, the standard console terminal is already configured for use 
with XENIX. However, other terminals of various types may be connected to a 
XENIX system. In these cases it is important to know how to set terminal 
options and how to specify the terminal you are using. You may also want to 
change the standard configuration of the standard console terminal. The 
following section discusses these topics. 



4.3.1 Changing Terminals 

If you ever need to log in to XENIX on a terminal of a type different than the 
terminal you normally use, you may need to change the shell TERM variable. 
This is normally set to the proper terminal when you log in, but if you switch 
terminal types you will have to reset the TERM variable. To reset this variable, 
type the following line at command level: 

TERM=<e rmname 

where termname is the name of a known terminal. A list of known terminals is 
described in tcrmtno/«(M). A variety of terminals are supported; terminal 
capabilities are listed in the system file /ete/termcap. 
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4.3.2 Setting Terminal Options 

There are a number of terminal options that can be set with the command stty . 
When entered without parameters, stty displays the current terminal settings. 
For example, typical output might look like this: 

speed 9600 baud 
erase '*h' ; kill '*u' 
even -nl 

Each of the above characteristics can be set with stty. For more information, 
see etty(C) in the XENIX Reference Manual. 



4.4 Editing the Command Line 

When you sit in front of a terminal and type commands at your keyboard, there 
are a number of special keys that you can use. The most useful ones are 
described below. 



4.4.1 Entering a Command Line 

From your terminal, entering a command line consists of typing characters 
then pressing RETURN. Once you have pressed RETURN the computer reads 
the command line and commands specified on that line are executed. You may 
type as many command lines as you want without waiting for commands to 
complete, because XENIX supports type-ahead of characters. 



4.4.2 Erasing a Command Line 

When entering commands, typing errors are bound to occur. To erase the 
current command line, press CNTRL-U. 



4.4.3 Halting Screen Output 

In many cases, you will be examining the contents of a file on the terminal 
screen. For longer files, the contents will often scroll off the screen faster than 
you can examine them. To temporarily halt a program's output to the terminal 
screen, press CNTRL-S. To resume output, press CNTRL-Q. 



4.5 Manipulating Files 

File manipulation (creating, displaying, combining, copying, moving, naming, 
and deleting files), is one of the most important capabilities an operating system 
provides. The XENIX commands that perform these functions are described in 
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the following sections. 

4.5.1 Creating a File 

To create a file and place text in it, use the editor vi, described in Chapter 5 of 
this manual, "Vi: A Text Editor". If for some reason you wish to create an 
empty file, type 

> filename 

Where filename is the name of the empty file. In general, new files are created 
by commands ae needed. 



4.5.2 Displaying File Contents 

The more command displays the contents of a file one screenful at a time. It has 
the form 

more options filename 

More is useful for looking at a file when you don't want to make changes to it. 
For example, to display the contents of the file memos, type 

more memos 

More can be invoked with options that control where the display begins, and 
how the file is displayed. These options include: 

•{■line number 

Begins the display at the line in the file designated by linenumber. 



+/tezt 



Begins the display two lines before text, where text is a word or 
number. If text is two or more words, they must be enclosed in double 
quotation marks. 



-c Redraws the screen instead of scrolling. 

-r Displays control characters, which are normally ignored by more. 

To begin looking at the file memo at the first occurrence of the words "net 
gain", for example, type 

more +/"net gain" memo 

If the file is more than one screenful long, the percentage of the file that remains 
is displayed on the bottom line of the screen. To look at more of the file, use the 
following scrolling commands: 

4-5 



XENIX Users Guide 

RETURN Scrolls down one line. 

d Scrolls down one-half screen. 

SPACE Scrolls down a full screen. 

nSPACE Scrolls down n lines. 

. Repeats the previous command. 

You cannot scroll backward, toward the beginning of the file. 

You can search forward for patterns in more with the slash (/) command. For 
example, to search for the pattern "net gain", type 

/net gain/ 
and press RETURN. More displays the message 

skipping... 

at the top of the screen, and scrolls to a location two lines above 'net gain". 

If you are looking at a file with more and decide you want to change the file, you 
can invoke the vi editor by pressing 

v 

See Chapter 5, "Vi: A Text Editor" for information on using vi. 

More quits automatically when it reaches the end of a file. To exit more before 
the end of a file, type 



The head and tail commands display the first and last ten lines of a file, 
respectively. They are useful for checking the contents of a particular file. 

For example, to look at the first ten lines of the file memo, type 

head memo 

You can also specify how many lines the head and tail commands display. For 
example, 

tail -4 memo 

displays the last four lines of memo. 



4-6 



Tasks 

The cat command also displays the contents of a file. Cat scrolls the file until 
you press CNTRL-S to stop it. Pressing CNTRL-Q will continue the scrolling. 
Cat stops automatically at the end of a file. If you wish to stop the display 
before the end of the file, press INTERRUPT. To display the contents of one file, 
type 

cat filel 

To display the contents of more than one file, type 

cat filel file2 file3 

4.5.3 Combining Files 

The cat command is frequently used to combine files into some other new file. 
Thus, to combine the two files named filtl and file2, into a new file named 
bigfile, type: 

cat filel file2 > bigfile 

Note here that we are putting the contents of the two files into a new file with 
the name bigfile. The greater than sign ( > ) is used to redirect output of the 
cat command to the new file. 

You can also use cat to append one file to the end of another file. For example, 
to append /Wei to /Kef, type 

cat filel > > file2 

The contents of filel are added to file 2. Filel still exists as aseparate entity. 

4.5.4 Moving a File 

The mv command moves a file into another file in the same directory, or into 
another directory. For instance, to move a file named text to a new file named 
book, type: 

mv text book 

After this move is completed, no file named text will exist in the working 
directory, because the file has been renamed book. 
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To move a file into another directory, give the name of the destination 
directory as the final name in the mv command. For instance, to move filel and 
/i/e2intothe directory named /tmp, type: 

mv filel file2 /tmp 

The two files you have moved no longer exist in your working directory, but 
now exist in the directory /tmp. The above command has exactly the same 
effect as typing the following two commands: 

mv filel /tmp/filel 
mv file2 /tmp/file2 

The mv command always checks to see if the last argument is the name of a 
directory and, if so, all files designated by filename arguments are moved into 
that directory. 



4.5.5 Renaming a File 

To rename a file, simply "move" it to a file with the new name: the old name of 
the file is removed. Thus, to rename the file anon to johndoe, type: 

mv anon johndoe 

Note that moving and renaming a file are essentially identical operations. 

4.5.6 Copying a File 

There are two forms of the cp command: one in which files are copied into a 
directory, and another in which a file is copied to another file. Thus, to copy 
three files into a directory named file dir, type: 

cp filel file2 file3 filedir 

In the above command, three files are copied into the directory filedir; the 
original versions still reside in the working directory. Note that the filenames 
are identical in the two directories. Like the mv command, cp always checks to 
see if the last argument is the name of a directory, and, if so, all files designated 
by filename arguments are copied into that directory. 

To create two copies of a file in your own working directory, you must rename 
the copy. To do this, the copy command can be invoked as follows: 

cp file file copy 

After the above command has executed, two files with identical contents reside 
in the working directory. To learn how to copy directories, see section 4.6.7, 
"Copying aDirectory", later in this chapter. 
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4.5.7 Deleting a File 

To delete or remove files, type: 

rm filel file2 

In the above command, the files filel and fileSzrt removed from your working 
directory. The command 

rm -i filel file2 

allows you to interactively remove files by asking you if you really want to 
delete each of the files filel and file 2. If you press y followed by a RETURN, the 
given file is removed; if you press n the file is left untouched. This command is 
useful when cleaning up a directory that contains many files. 

4.5.8 Finding Files 

The find command searches for files that have a specified name. Find is useful 
for locating files that have the same name, or just for finding a file if you have 
forgotten which directory it is in. The command has the form: 

find pathname -name filename -print 

The pathname is the pathname of the directory you want to search. Find 
searches recursively, that is, it starts at the named directory and searches 
downward through all files and subdirectories under the directory specified in 
pathname. 

The "-name" option indicates that you are searching for files that have a 
specific filename. (There are other search conditions you can use with find; see 
fina\C) in the XENIX Reference Manual.) 

Filename is the name of the file you are sear ching for. 

The "-print" option indicates you want to print the pathnames of all the files 
that match filename on your terminal screen. You may direct this output to a 
file instead of your screen with the output redirection symbol, >. (There are 
other actions that can be performed with find, such as removing and moving 
files; see fina\C) in theXENIX Reference Manual.) 

For example, the following command finds every file named memo in the 
directory /uer/joe and all its subdirectories: 

find /usr/joe -name memo -print 

The output might look like this: 
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/usr /joe/memo 
/usr /joe/accounts/memo 
/usr /joe/meetings/memo 
/usr /joe/mail/memo 



4.5.0 Linking a File to Another File 

The In command joins two files in different directories so that when the file is 
changed in one directory, it is also changed in the other directory. This can be 
useful if several users need to share information, or if you want a file to appear 
in more than one directory. This command has the form 

In file new file 

where file is the original file, and new file is the new, linked file. For example, the 
following command links memos in /usr/ joe to joe memos in /usr/mary: 

In /usr/joe/memos /usr/mary/joememos 

Whenever /usr/ joe /memos is updated, the file /usr/mary/joememos is also 
changed. 

When you link files a name is associated with an inode. An inode specifies a 
unique set of data on the disk. One or more names can be associated with this 
data. Thus, the above command assures that the files dirl/filel and dir2/file2 
have identical contents. 

There are three things to remember about linking files that are not 
immediately obvious: 



1 . Linking large sets of files to other parallel files can save a considerable 
amount of disk space. 

2. Linking files used by more than one person is risky, because any party 
can alter the file and thus affect the contents of all files linked to it. 

3. Removing a file from a directory does not remove other links to the 
file. Thus the file is not truly deleted from the system. For example, if 
you delete a file that has 4 links, 3 links remain. 

For more information about linking see ln[C) in the XENIX Reference Manual. 



4.8 Manipulating Directories 

Because of the hierarchical organization of the file system, there are many 
directories and subdirectories in the XENIX system. Within the file system are 
directories for each user of the system. Within your user directory you can 
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create, delete, and copy directories. Commands that let you manipulate 
directories are described in the following sections. 



4.6.1 Printing the Name of Your ^iVorking Directory 

All commands are executed relative to a "working" directory. The name of this 
directory is given by the pwd command, which stands for "print working 
directory". For instance, if your current working directory is /v$r/joe, when 
you type: 

pwd 
you will get the output: 

/usr/joe 
You should always think of yourself as residing "in" your working directory. 

4.6.2 Listing Directory Contents 

You can list the contents of a directory with the Ic command. This command 
sorts and lists the names of files and directories in a given directory in columns. 
If no directory name is given, lc lists the contents of the current directory. The 
lc command has the form 

lc options name 
For example, to list the contents of the directory work, type 

lc work 

Your output might look like this: 

accounts meetings notes 
mail memos todo 

If no name is specified, lc lists the contents of the current directory. If accounts 
is the current directory, for example, the command 

lc 

lists the names of the files and subdirectories in that directory. 

The following options control the sort order and the information displayed by 
the lc command: 

-a Lists all files in the directory, including the "hidden" files (filenames that 
begin with a dot, such as .profile and .mailrc ). 

4-11 



XENIX User's Guide 



-r Lists names in reverse alphabetical order. 

-t Lists names in order of last modification, the latest (most recently 
modified) first. When used with the -r option, lists the oldest first. 

-R Lists all files and directories in the current directory, plus each file and 
directory below the current one. The "R" stands for "recursive". 

-F Marks directories with a backslash(\) and executable files with an 
asterisk (*). 

The 1 command gives a "long" listing of a directory, producing an output that 
might look something like this: 



total 501 


















drwxr -x 


2 


bor i s 


grpl 


272 Apr 


5 


14: 


33 


dirl 


drwxr-x 


2 


en i d 


grpl 


272 Apr 


5 


14: 


33 


dir2 


drwxr-x--- 


2 


iris 


grpl 


592 Apr 


6 


11: 


: 12 


dir3 


-rw-r 


1 


olaf 


grp2 


282 Apr 


7 


15: 


11 


filel 


-rw-r 


1 


olaf 


grp2 


72 Apr 


7 


13: 


50 


file2 


-rw-r 


1 


olaf 


grp2 


1403 Apr 


1 


13: 


22 


file3 



Reading from left to right, the information given for each file or directory 
includes: 

— Permissions 

— Number of links 

— Owner 

— Group 

— Size in bytes 

— Time of last modification 

— Filename 

The information in this listing and how to change permissions are discussed 
below in Section 4.8, "Using File and Directory Permissions". 

The 1 command takes the same options as lc. 

For more information about listing the contents of a directory, see lt[C) in the 
XENIX Reference Manual. 
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4.6.3 Creating a Directory 

To create a subdirectory in your working directory, use the mkdir command. 
For instance, to create anew directory named phonenumbert, simply type: 

mkdir phonenumbers 

After this command has been executed, a new empty directory will exist in your 
home directory. 



4.6.4 Removing a Directory 

To remove a directory located in your working directory, use the rmdir 
command. For instance, to remove the directory named phonenumbers from 
the current directory, simply type: 

rmdir phonenumbers 

Note that the directory phonenumbers must be eroptybefore it can be removed; 
this prevents catastrophic deletions of files and directories. If you want to live 
dangerously, it is possible to recursively remove the contents of a directory 
using the rm command, but that will not be explained here. See rm(C) in the 
XENIX Reference Manual tor more information. 



4.6.5 Renaming a Directory 

To rename a directory, use the mv command. For instance, to rename the 
directory little, dir to big. dir, type: 

mv little. dir big.dir 

This is a simple renaming operation; no files are moved. 

4.6.6 Moving a Directory 

The mv command also moves directories. This command has the form 

mv oldirectory newdirectory 

where Newdirectory is a directory that already exists. For example, to move 
the directory / uer/ joe/ ace ountsinto / usr/ joe/ overdue type 

mv /usr /joe/accounts /usr/joe/overdue 

The new pathname of /usr/ joe/ accounts is /tier/ joe/ overdue/ accounts. 
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4.6.7 Copying a Directory 

The copy command copies directories. This command has the form 

copy options olddir newdir 
To copy all the files in the directory /usr/joe/me mo$ into /tier/ joe/ notee type 

copy /usr/joe/memos /usr /joe/notes 

The files in /uer/joe/memoe are copied into /u$r/joe/note$. The copy 
command has the following options: 

-1 Links the copied files to the original. 

-m Gives the copied files the same modification dates as the original files. 

-r Copies the directory recursively, i.e., copies all the directories under the 
named directory. 



4.7 Moving in the File System 

When using the XENIX system, it helps to imagine a large tree structure of files 
and directories. Each directory should be thought of as a place that you can 
move into or out of. At all times you are "someplace" in the tree structure. This 
place is called either your working directory or current directory. The 
commands used to find out where you are and to move around in the tree 
structure are discussed below. 



4.7.1 Finding Out Where You Are 

Your current location in the file system is the name of the working directory. 
You can find out this name by using the pwd command, which stands for 
"print working directory". For example, if you are in the directory /vtr then 
typing the command 

pwd 

prints out the name: 

/usr 



4.7.2 Changing Your Working Directory 

Your working directory represents your location in the file system: it is "where 
you are" in XENIX. To alter this location in the XENIX file system, use the 
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change directory (cd) command: 

cd 

This changes your working directory to your home directory. To move to any 
other directory, specify that directory as an argument to cd. For instance, the 
following command: 

cd /usr 

moves you to the fuer directory. Because you are always "in" your working 
directory, changing working directories is much like "traveling" from 
directory to directory. 

To move up one directory from your current directory, type 

cd.. 

For example, the above command would move you from the directory 
/usr/joe/workto /uer/joe. Similarly, the command 

cd ../.. 

would move you from the directory /utr/ joe/ work to /usr, moving you up two 
directories. 



4.8 Using File and Directory Permissions 

The XENIX system allows the owner to restrict access to files and directories, 
limiting who can read, write and execute flies owned by him. To determine the 
permissions associated with a given file or directory, use the 1 command. The 
output from the 1 command should look something like this: 



total 501 


















drwxr-x 


2 


bor is 


grpl 


272 Apr 


5 


14: 


33 


dirl 


drwxr-x 


2 


eni d 


grpl 


272 Apr 


5 


14: 


33 


dir2 


drwxr-x 


2 


iris 


grpl 


592 Apr 


6 


11: 


12 


dir3 


-rw-r 


1 


olaf 


grp2 


282 Apr 


7 


15: 


11 


filel 


-rw-r 


1 


olaf 


grp2 


72 Apr 


7 


13: 


50 


file2 


-rw-r 


1 


olaf 


grp2 


1403 Apr 


1 


13: 


22 


file3 



Permissions are indicated by the first ten characters of the output. The 
permissions for the first file in the above list, are 

drwxr-x-*- 

The first character indicates the type of file and must be one of the following: 
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Indicates an ordinary file. 

d Indicates a directory. 

c Indicates a character special device such as a lineprinter or terminal. 

b Indicates a block special device such as a hard or floppy disk. 

n Indicates a name special file (i.e., a semaphore used for controlling 

access to some resource). 

s Indicates a shared data file. 

p Indicates a named pipe. 

From left to right, the next nine characters are interpreted as three sets of three 
permissions each. Each respective set of three indicates the following 
permissions: 

— Owner permissions 

— Group permissions 

— All other user permissions 

Within each set, the three characters indicate permission to read, to write, and 
to execute the file as a command, respectively. For a directory, "execute" 
permission means permission to search the directory for any included files or 
directories. 

Ordinary file permissions have the followingmeanings: 

r The file is readable. 

w The file is write able. 

x The file is executable. 

The indicated permission is not granted. 

For directories, permissions have the following meanings: 

r Files can be listed in the directory; the directory must also have "x" 

permission. 

w Files can be created or deleted in the directory; as with "r", the 

directory itself must also have "x" permission. 

x The directory can be searched. A directory must have "x" permission 

before you can move to it with the cd command (i.e., cdto it), access a 
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file within it, or list the files in it. Remember that a user must have 
"x" permission to do anything ueeful to the directory. 

The following are some typical directory permission combinations: 



d No access at all. This is the mode that denies access to the 

directory to a class of users. 

drwx Allows access by the owner to use lc, create files, delete files, 

access files (subject to file permissions), and cd to the 
directory. This is the typical permission for the owner of a 
directory. 

drwxr-x — Allows access by members of the group to use lc, and access 

files subject to file permissions. Group members can cd to this 
directory, but cannot create or delete files in it. This is the 
typical permission an owner gives to others who need access 
to files in his directory. 

drwx— x—x With these permission settings users other than the owner 

cannot use lc but can cd to the directory. Other users can 
only access a file within this directory by its exact name; they 
cannot use special characters. Files cannot be created or 
deleted in the directory by anyone except the owner. This 
mode is rarely used, but can be useful if you want to give 
someone access to a specific file in a directory without 
permitting access to other files in the same directory. 
< 

This chapter discusses ordinary files, executable files, and directories only. For 

information about other types of files, see /«(C) in the XENIX Reference 

Manual. 



4.8.1 Changing Permissions 

The chmod command changes the read, write, execute, and search 
permissions of a file or directory. This command is useful if you have created a 
file in one mode, but want to give others permission to read, write or execute it. 
The chmod command has the form 

chmod instruction filename 

The instruction segment of the command indicates which permissions you 
want to change for which class of users. There are three classes of users, and 
they are are indicated as follows: 

u Use r , the o wner of the fi le or di r e ctory 

g Group, the group the owner of the file belongs to 
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o Other, all users of the system 

a All classes of users 

There are three types of permissions, as follows: 

r Read, which allows permitted users to look at but not change or delete the 
file. 

w Write, which allows permitted users to change or even delete the file. 

x Execute, which allows permitted users to execute the file as a command. 

For example, assume filel exists with the following permissions: 

-rw-r 

In the above example, the owner of the file has read and write permission, group 
members have read permission, and others have no access at all. 

To give filel read permission for all classes of users, type: 

chmod a+r filel 

In the instruction segment of the command (a+r) the "a" stands for "all". The 
resulting permissions are: 

•rw-r-r- 

For file 1 with the attributes 

-rw 

The following command gives write and execute permissions to members of a 
group only: 

chmod g+wx filel 

This command would alters the permission attributes so they look like this: 



To remove write and execute permission by the user (owner) and group 
associated with filel, type: 

chmod ug-wx filel 
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4.8.2 Changing Directory Search Permissions 

Directories also have an execute permission. This attribute signifies search 
permission, rather than execute permission, since directories cannot be 
executed. If this permission is denied to a particular user, then that user cannot 
even list the names of the files in the directory. 

For example, assume that the directory dirl has the following attributes: 

drwxr-xr-x 
To remove search permission for other users to examine iirl, type: 

chmod o-xr dirl 
The new attributes for dirl are: 

drwxr-x — 



4.9 Processing Information 

In many cases, files will contain information that you may want to process. 
Various utility programs exist on XENIX to process information. A set of these 
programs and their uses are described in the following sections. 



4.9.1 Comparing Files 

To compare two text files use the diff command to print out those lines that 
differ between the files that you specify. For example, suppose that a file named 
men has the contents 

Now is the time for all good men to 
Come to the aid of their party. 

and that a file named women has the following contents: 

Now is the time for all good women to 
Come to the aid of their party. 

If this is the case, then the command 

diff men women 

produces the following results: 
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lcl 

< Now is the time for all good men to 

> Now is the time for all good women to 

A three-way difference listing can be created with the difT3 command. For 
information about diff3 see diffS[C) in the XENIX #e/erentfeManual. 



4.0.2 Echoing Arguments 

The echo command echos arguments to the standard output. For example, 
typing: 

echo hello 

outputs: 

hello 

on the terminal screen. To output several lines of text, surround the echoed 
argument in double quotation marks and press RETURN between lines. A 
secondary prompt will appear until you type the final double quotation mark. 
For example, type: 

echo "Now is the time 
For all good men 
To come to the 
Aid of their party." 

This will output: 

Now is the time 
For all good men 
To come to the 
Aid of their party. 

Echo is particularly useful if you should ever program in the shell command 
language. For more information about the shell, see Chapter 7, "The Shell". 



4.0.3 Sorting a File 

One of the most useful file processing commands is sort. By default, sort sorts 
the lines of a file according to the ASCII collating sequence (i.e., it alphabetizes 
them). For example, to sort a file named phoneliet, type: 

sort phonelist 

In the above case, the sorted contents of the file are displayed on the screen. To 
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create a sorted version of phonclist named phoneeort, type: 

sort phonelist >phonesort 

Note that sort is useful for sorting the output from other commands. For 
example, to sort the output from execution of a who command, type: 

who | sort >whosort 

This command takes the output from who, sorts it, and then sends the sorted 
output to the file whoeort. 

A wide variety of options are available for sort. For more information, see 
•ort(C) in the XENIX Reference Manual. 

4.9.4 Searching for a Pattern in a File 

The grep command selects and extracts lines from a file, printing only those 
lines that match a given pattern. For example, to print out all lines in a file 
containing the word "tty38", type: 

grep 'tty38'file 

In general, you should always enclose the pattern you are searching for in single 
quotation marks ( '), so that special metacharacters are not expanded 
unexpectedly by the shell. 

As another example, assume that you have a file named phonelist that contains 
a name followed by a phone number on each line. Assume also that there are 
several thousand lines in this list. You can use grep to find the phone number 
of someone named Joe, whose phone number prefix is 822, as follows: 

grep 'joe ' phonelist J grep '822- ' >joes.number 

Grep finds all occurrences of lines containing the word "joe" in the file 
phoneliet. The output from this command is then filtered through another 
grep command, which searches for an "822-" prefix, thus removing any 
unwanted joes. Finally, assuming that a unique phone number for joe exists 
with the "822-" prefix, that name and number are placed in the file 
joee. number. 

For more information about grep, its relatives fgrep and egrep, and the 
types of patterns it can be used to search for (called regular expressions) see 
grep(C) in the XENIX R efe re nee Manual. 
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4.9.5 Counting Words, Lines, and Characters 

Wc is a utility for counting words in a file. The letters "wc" stand for word 
count. Words are presumed to be separated by punctuation, spaces, tabs, or 
newlines. Wc also counts characters and lines; all three counts are reported by 
default. For example, to count the number of lines, words, and characters in 
the file textfile, type: 

wc textfile 

Typical output describing lines, words and characters might be: 

4432 18188 97808 textfile 

To specify a count of characters, words, or lines only, you must use an 
appropriate mnemonic switch. To illustrate, examine the following three 
commands and the output produced by each: 

wc -c textfile 
97808 textfile 

wc -w textfile 
18188 textfile 

wc -1 textfile 
4432 textfile 

The first example prints out the number of characters in textfile, the second 
prints out the number of words, and the third prints out the number of lines. 

4.0.6 Delaying a Process 

The at program allows you to set up commands to be executed at a specified 
time. It is useful if you want to execute a command when you are not planning 
to be at your terminal, or even logged in. 

The at command has the form 

at time day file 

Time is the time of day, in digits, followed by "am" or "pm". One- and two- 
digit numbers are interpreted as hours, three- and four-digit numbers as hours 
and minutes. More than four digits is not permitted. 

Day is optional. It is either a month name followed by a day number, or a day of 
the week. If no day is specified, the command will be executed today. 
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File is the name of the file that contains the command or commands to be 
executed. 

For example, if you want to find out what processes are running at 10 pm on 
Tusday , place the following line in a file named u$e 

ps a > /usr/myname/use 

(See Chapter 6, "Vi: A Text Editor", for information on creating and inserting 
text into files.) 

After you have written out the file and returned to command level, type 

at 10pm tues use 

Press RETURN. The XENIX prompt reappears and you may continue working. 
At 10 pm on Tuesday, XENIX will execute psa and place the output in the file 
uee. At is unaffected by logging out. 

To check what files you have waiting to be processed, use the atq command. 
Atq lists the files to be processed, along with the following information: 

— The file's user ID 

— The file's ID number 

— The date and time the file will be processed 

To cancel an at command, first check the list of files to be processed and note 
the file ID number. Then use the atrm command to remove the file or files from 
the list. The atrm command has the form: 

atrm number 

For example, 

atrm 84.032.2300.21 

removes file number 84.032.2300.21, canceling whatever commands were 
included in that file. A user can only remove his own files. 



4.10 Controlling Processes 

In XENIX, several processes can run at the same time. For example, you may 
run the sort program on a file in the "background", and edit another file in the 
"foreground" while the sort program is running. Things that you directly 
control at your keyboard are called "foreground" processes. Other processes, 
which you can initiate but thatyou otherwise have little control over, are called 
background processes. At any one time you can have only one foreground 
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process executing, but multiple background processes may execute 
simultaneously. Controlling foreground and background processes is the 
subject of this section. 



4.10.1 Placing a Process in the Background 

Normally, commands sent from the keyboard are executed in strict sequence; 
one command must finish executing before the next can begin. Executing 
commands of this type are called foreground processes. A background process, 
in contrast, need not finish executing before you give your next command. 
Background commands are especially useful for commands that may take a 
long time to complete. 

To place a process in the background, type an ampersand (&) at the end of the 
command. For example, to count the number of words in several large files 
while simultaneously continuing with whatever else you have to do, type: 

wc filel file2 file3 >count& 

Output is collected in the file count. If output were not put in count, it would 
appear on the screen at unpredictable times as you continue with your work. 

When processes are placed in the background, you lose control of them as they 
execute. For instance, typing INTERRUPT does not abort a background 
process. You must use the kill command, described in the following section, 
instead. 



4.10.2 Killing a Process 

To stop execution of a foreground process, press your terminal's INTERRUPT 
key. This kills whatever foreground command is currently running. To kill all 
your processes executing in the background, type: 

kill 

To kill only a specified process executing in the background, first type: 

ps 

Ps displays the Process Identification Numbers (PIDs) of your existing 
processes: 

PID TTY TIME CMO 
3459 03 0: 15 -sh 
4831 03 1:52 cc program, s 
5185 03 0:00 ps 

Next, you might type 
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kill 4831 
where 4831 is thePID of the process that you want killed. 



Note 



Killing a process associated with the vi editor may leave the terminal 
in a strange mode. Also, temporary files that are normally created 
when a command starts, and are deleted when the command finishes, 
may be left behind after a kill command. Temporary files are 
normally kept in the directory /tmp. This directory should be 
checked periodically and old files deleted. 



4.11 Getting Status Information 

Because XENIX is a large, self-contained computing environment, there are 
many things that you may want to find out about the system itself, such as who 
is logged in, how much disk space there is, what processes are currently 
running. This section explains the types of information available from the 
system and how to get it. 



4.11.1 Finding Out Who is on the System 

The who command lists the names, terminal line numbers, and login times of 
all users currently logged on to the system. For example, type: 

who 

This command produces something like the following output on your terminal 
screen: 

arnold tty02 Apr 7 10:02 



daphne 


tty21 


Apr 


7 


07: 


:47 


e 1 1 i ot 


tty23 


Apr 


7 


14: 


21 


e 1 1 en 


tty25 


Apr 


7 


08: 


36 


gus 


tty26 


Apr 


7 


09: 


55 


adr i an 


tty28 


Apr 


7 


14: 


21 



The finger command provides more detailed information, such as office 
numbers and phone extensions. For more information, about using finger see 
Jinger(C) in theXENIX Reference Manual. 
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4.11.2 Finding Out What Processes Are Running 

Because commands can be placed in the background for processing, it is not 
always obvious which processes you are responsible for. The ps command 
stands for "process status" and displays information about currently running 
processes associated with your terminal. For instance, the output from a ps 
command might look like this: 

PID TTY TIME CMD 
10308 38 1:36 ed chap02.man 

49 38 0:29 -sh 
11267 38 0:00 ps 

The PID column gives a unique process identification number that can be used 
to kill a particular process. The TTY column shows the terminal that the 
process is associated with. The TIME column shows the cumulative execution 
time for the process. Processes can be killed using the kill command. See 
section 4.10.2, "Killing a Process 1 ' for information on how to use the kill 
command. 

To find out all the processes running on the system, use the a option: 

ps a 

To find out about the processes running on a terminal other than the terminal 
you are using, specify the terminal number. For example, to find out what 
processes are associated with terminal 13, type: 

ps tl3 

For more information about ps and its options, see pt(C) in the XENIX 
Reference Manual. 



4.11.3 Getting Lineprinter Information 

At times it may be necessary to know how many files are queued up at the 
lineprinter. This information can be found by listing the directory in which 
queued files reside, /uer/epool/lpd. To examine this directory, type: 

Is -1 /usr/spool/lpd 



4.12 Using the Lineprinter 

The following sections describe the commands that will help you use your 
lineprinter effectively and efficiently. 
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4.12.1 Sending a File to the Lineprinter 

One of the most common operations that you will want to perform is printing 
files on the lineprinter. The most straightforward method for doing this is to 
type 

lpr filel 

for one file, or: 

lpr filel file2 file3 

for multiple Mies. Other common uses of lpr involve pipes. For instance, to 
paginate and print a file of raw text, type: 

pr textfile | lpr 

The pr and lpr commands are very often used together. As another example, 
to sort, paginate, and print a file, type: 

sort datafile | pr | lpr 



4.12.2 Getting Lineprinter Queue Information 

XENIX does not require that a file be entirely printed before the lpr command 
finishes. Instead, lpr makes sure only that the file is placed in a special 
directory where it will wait its turn to be printed. 

The files in this queue are contained in the directory /uer/epool/lpd. To 
examine this lineprinter queue, type: 

Is -1 /usr/spool/lpd 



4.13 Communicating with Other Users 

Because the XENIX system supports multiple users, it is very convenient to 
communicate with other users of the system. The various methods of 
communication are described below. 



4.13.1 Sending Mail 

Mail is a system- wide facility that permits you and other system users to send 
and receive mail. To send mail to another user on the system, type: 

mail joe 
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where joe is the name of any user of the system. Following entry of the 
command, you enter the actual text of the message you want to send. Entry of 
text is terminated by typing a CNTRL-D. 

A complete session at the terminal might look like this on your screen: 

mail -s "Meeting today" joe 

There will be a meeting at 2:00 today 

to review recent problems with the 

new system. 

CNTRL-D 

Note the use of the -s switch to specify the subject of the message. 

For practice, send mail to yourself. (This isn't as strange as it might sound — 
mail to yourself is a handy reminder mechanism.) You can also send a 
previously prepared letter, and you can send mail to a number of people all at 
once. For more details see Chapter 6, "Mail", and ma»7(C) in the XENIX 
Reference Manual. 



4.13.2 Receiving Mail 

When you log in, you may sometimes get the message: 

you have mail 
To read your mail, type: 

mail 

A heading for each message is then displayed on your terminal screen. When 
you press RETURN, the contents of the first message are displayed. Subsequent 
messages are displayed, one message at a time, most recent message first, each 
time you press RETURN. 

After each message is displayed, mail waits for you to tell it what to do with the 
message. The two basic responses are d, which deletes the message, and 
RETURN, which does not delete the message (so it will still be there the next 
time you read your mailbox). To exit mail, type q, for "quit". Other responses 
are described in theXENIX Reference Manual under mail(C). 

4.13.3 Writing to a Terminal 

To write directly to another user's terminal, use the write command. For 
example, to write to joe's terminal, type: 

write joe 



4-28 



Tusks 



After you have executed the command by pressing RETURN, each subsequent 
line that you type is displayed both on your own terminal screen and on joe's. 
To terminate the writing of text to joe, enter a CNTRL-D alone on a line. The 
procedure for a two-way write is for each party to end each message with a 
distinctive signal, normally (o) for "over"; when a conversation is about to be 
terminated use the signal (oo) for "over and out". 



4.14 Using the System Clock and Calendar 

There are several XENIX commands that will tell you the date and time, or 
display a calendar for any month or year you choose. The following sections 
explain these commands. 



4.14.1 Finding Out the Date and Time 

The date command displays the time and date. Type 

date 
The date and time are displayed in the bottom left corner of the screen. 

4.14.2 Displaying a Calendar 

The cal command displays the calendar of any month or year you specify. This 
command has the form: 

cal month year 
For example, to display the calendar for March, 1952 type 

cal 3 1952 

The result is: 

March 1952 

S M Tu WTh F S 

1 

2 3 4 5 6 7 8 

9 10 11 12 13 14 15 

16 17 18 19 20 21 22 

23 24 25 26 27 28 29 

30 31 

The month must always be expressed as a digit. To display the calendar for an 
entire year, leave out the month. The year must always be expressed in full; the 
command "cal 84" displays the calendar for the year 84, not 1984. 
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4.15 Using the Automatic Reminder Service 

An automatic reminder service is normally available for all XENIX users. Once 
each day, XENIX uses the calendar command to examine each user's home 
directory for a file named calendar, the contents of which might look something 
like this: 

1/23 David's wedding 
2/9 Mira's birthday 
3/30 Paul's birthday 
4/27 Meeting at 2:00 
9/1 Karen's birthday 
10/3 License renewal 

Calendar examines each line of the calendar file, extracting from the file those 
lines containing today's and tomorrow's dates. These lines are then mailed to 
you to remind you of the specified events. 



4.16 Using Another User's Account 

You can easily access another user's files, regardless of the permission settings, 
with the su command. The su procedure resembles logging in, and you must 
know the other user's password. For example, to become user Joe, type 

su joe 

and press RETURN. When the password prompt appears, type Joe's password. 
To cancel the effect of the su command and return to your own account, press 
CNTRL-D. 



4.17 Calculating 

The be command invokes an interactive desk calculator that can be used as if it 
were a hand-held calculator. A typical session with be is shown below. 
Comments explain what action is performed after each input line: 
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/* This is a comment */ 






123.456789 + 987.654321 


/* Add and 


output */ 


1111.111110 






9.0000000 


i - 9.0000001 


/* Subtract 


and output */ 


-.0000001 








64/8 /* 

8 

1.1234567 


Divide and output */ 




8934 * 2.3 


/* Note pre 


cision */ 


2.58395061548 






19%4 /* 

3 

3 4 /* 


Find remainder 


*/ 




Exponentiation 


*/ 




81 








2/1*2 /* 
4 

2/(1*2) 

1 

x = 46.5 


Note precedence 


V 




/* Note 


precedence ; 


again */ 


/* Assig 


jn value to x 


*/ 


y = 52.5 


/* Assign value to y 


*/ 


x +y + ] 


1. 0000 /* Add 


and output < 


'/ 


100.0000 








obase=lt 


> /* Set hex output base */ 


15 /* 
F 

16 /* 


Convert to hex 


*/ 




Convert to hex 


*/ 




10 








64 /* 


Convert to hex 


*l 




40 








255 /* 


Convert to hex 


*/ 




r r 

256 /* 


Convert to hex 


*/ 




100 








512 /* 


Convert to hex 


*/ 




200 








quit /* 


Must type whole 


word */ 





Also available are scaling, function definition, and programming statements 
much like those in the C programming language. Other features include 
assignment to named registers and subroutine calling. For more information, 
see Chapter 8, "BC: A Calculator". 
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5.1 Introduction 



Any ASCII text file, such as a program or document, may be created and 
modified using a text editor. There are two text editors available on the XENIX 
system, ed and vi. Ed is discussed in Appendix A of this manual. 

Vi (which stands for "visual") combines line-oriented and screen-oriented 
features into a powerful set of text editing operations that will satisfy any text 
editing need. 

The first part of this chapter is a demonstration that gives you some hands-on 
experience with vi. It introduces the basic concepts you must be familiar with 
before you can really learn to use vi, and shows you how to perform simple 
editing functions. The second part is a reference that shows you how to perform 
specific editing tasks. The third part describes how to set up your vi 
environment and how to set optional features. The fourth part is a summary of 
commands. 

Because vi is such a powerful editor, it has many more commands than you can 
learn at one sitting. If you have not used a text editor before, the best approach 
is to become thoroughly comfortable with the concepts and operations 
presented in the demonstration section, then refer to the second part for 
specific tasks you need to perform. All the steps needed to perform a given task 
are explained in each section, so some information is repeated several times. 
When you are familiar with the basic vi commands you can easily learn how to 
use the more advanced features. 

If you have used a text editor before, you may want to turn directly to the task- 
oriented part of this chapter. Begin by learning the features you will use most 
often. If you are an experienced user of vi you may prefer to use W(C) in the 
XENIX Reference Manua/instead of this chapter. 

This chapter covers the basic text editing features of vi. For more advanced 
topics, and features related to editing programs, refer to V»(C) in the XENIX 
Reference Manual. 



5.2 Demonstration 

The following demonstration gives you hands-on experience using vi, and 
introduces some basic concepts that you must understand before you can learn 
more advanced features. You will learn how to enter and exit the editor, insert 
and delete text, search for patterns and replace them, and how to insert text 
from other files. This demonstration should take one hour. Remember that the 
best way to learn vi is to actually use it, so don't be afraid to experiment. 

Before you start the demonstration, make sure that your terminal has been 
properly set up. See section 5.5.1, "Setting the Terminal Type" , for more 
information about setting up your terminal for use with vi. 
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5.2.1 Entering the Editor 

To enter the editor and create a rile named temp, type 

vi temp 
Your screen will look like this: 



'temp" [New fi lei 



Note that we show a twelve- line screen to save space. In reality, vi uses 
whatever size screen you have. 

You are initially editing a copy of the file. The file itself is not altered until you 
save it. Saving a file is explained later in the demonstration. The top line of 
your display is the only line in the file and is marked by the cursor, shown above 
as an underline character. In this chapter, when the cursor is on a character 
that character will be enclosed in square brackets ([ J). 



The line containing the cursor is called the 
current line. 



The lines containing tildes are not part of the file: they indicate lines on the 
screen only, not real lines in the file. 



5.2.2 Inserting Text 

To begin, create some text in the file fempby using the i (insert) command. To 
do this, press: 
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Next, type the following five lines to give yourself some text to experiment with. 
Press RETURN at the end of each line. If you make a mistake, use the BKSP key 
to erase the error and type the word again. 



Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



Press ESCAPE when you are finished. 

Like most vi commands, the i command is not shown (or "echoed") on your 
screen. The command itself switchesyou from command mode to insert mode. 



When you are in intert mode every 
character you type is displayed on 
the screen. In command mode the 
characters you type are not placed in 
the file as text; they are interpreted 
as commands to be executed on the 
file. If you are not certain which 
mode you are in, press ESC until you 
hear the bell. When you hear the bell 
you are in command mode. 



Once in insert mode, the characters you type are inserted into the file; they are 
not interpreted as vi commands. To exit insert mode and reenter command 
mode you will always press ESC. This switching between modes occurs often in 
vi, and it is important to get used to it now. 



5.2.3 Repeating a Command 

Next comes a command that you'll use frequently in vi: the repeat command. 
The repeat command repeats the most recent insert or delete command. Since 
we have just executed an insert command, the repeat command repeats the 
insertion, duplicating the inserted text. The repeat command is executed by 
typing a period (.) or "dot" . So, to add five more lines of text, type ".". The 
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repeat command is repeated relative to the location of the cursor and inserts 
text below the current line. (Remember, the current line is always the line 
containing the cursor.) After you type dot (.), your screen will look like this: 



Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



5.2.4 Undoing a Command 

Another command which is very useful (and which you'll need often in the 
beginning) is the undo command, u. Press 



and notice that the five lines you just finished inserting are deleted or 
"undone". 



Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



Now type 



again, and the five lines are reinserted! This undo feature can be very useful in 
recovering from inadvertent deletions or insertions. 
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5.2.5 Moving the Cursor 

Now let's learn how to move the cursor around on the screen. In addition to the 
arrow keys, the following letter keys also control the cursor: 

h Left 

1 Right 

k Up 

j Down 

The letter keys are chosen because of their relative positions on the keyboard. 
Remember that the cursor movement keys only work in command mode. 

Try moving the cursor using these keys. (First make sure you are in command 
mode by pressing the ESC key.) Then, type the H command to place the cursor 
in the upper left corner of the screen. Then type the L command to move to the 
lowest line on the screen. (Note that case is significant in our example: L moves 
to the lowest line on the screen; while 1 moves the cursor forward one 
character.) Next, try moving the cursor to the last line in the file with the goto 
command, G. If you type "2G" , the cursor moves to the beginning of the 
second line in the file; if you have a 10,000 line file, and type "8888G", the 
cursor goes to the beginning of line 8888. (If you have a 600 line file and type 
"800G" the cursor doesn't move.) 

These cursor movement commands should allow you to move around well 
enough for this demonstration. Other cursor movement commands you might 
want to try out are: 

• w Moves forward a word 

b Backs up a word 

Moves to the beginning of aline 

$ Moves to the end of a line 

You can move through many lines quickly with the scrolling commands: 

CNTRL-U Scrolls up 1/2 screen 

CNTRL-D Scrolls down 1/2 screen 

CNTRL-F Scrolls forward one screenful 

CNTRL-B Scrolls backward one screenful 
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5.2.6 Deleting 

Now that we know how to insert and create text, and how to move around 
within the file, we're ready to delete text. Many delete commands can be 
combined with cursor movement commands, as explained below. The most 
common delete commands are: 

dd Deletes the current line (the line the cursor is on), regardless of the 

location of the cursor in the line. 

dw Deletes the word above the cursor. If the cursor is in the middle of 

the word, deletes from the cursor to the end of the word. 

x Deletes the character above the cursor. 

d$ Deletes from the cursor to the end of the line. 

D Deletes from the cursor to the end of the line. 

dO Deletes from the cursor to the start of the line. 

Repeats the last change. (Use this only if your last command was a 
deletion.) 

To learn how all these commands work, we'll delete various parts of the 
demonstration file. To begin, press ESC to make sure you are in command 
mode, then move to the first line of the file by typing 

1G 

At first, your file should look like this: 



[Fjiles contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



To delete the first line, type 
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dd 



Your file should now look like this: 



[TJext contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



Delete the word the cursor is sitting on by typing 

dw 
After deleting, your file should look like this: 



[cjontains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
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You can quickly delete the character above the cursor by pressing: 

x 
This leaves: 



(o)ntains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



Now type a "w" command to move your cursor to the beginning of the word 
"lines" on the first line. Then, to delete to the end of the line, type 



Your file looks like this: 



ontains_ 

Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



To delete all the characters on the line before the cursor type: 
dO 

This leaves a single space on the line: 
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Lines contain characters. 
Files contain text. 
Text contains lines. 
Characters form words. 
Words form text. 
Lines contain characters. 
Characters form words. 
Words form text. 



For review, let's restore the first two lines of the file. 

Press "i" to enter insert mode, then type 

Files contain text. 
Text contains lines. 

Press ESC to go back to command mode. 

5.2.7 Searching for a Pattern 

You can search forward for a pattern of characters by typing a slash (/) 
followed by the pattern you are searching for, terminated by a RETURN. For 
example, make sure you are in command mode (press ESC), then press 

H 

to move the cursor to the top of the screen. Now, type 

/char 
Don't press RETURNyet. Your screen should look like this: 
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Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



/char_ 



Press RETURN. The cursor moves to the beginning of the word "characters" 
on line three. To search for the next occurrence of the pattern "char", press 
"n" (as in "next") . This will take you to the beginning of the word 
"characters" on the eighth line. If you keep pressing "n" vi searches past the 
end of the file, wraps around to the beginning, and again finds the "char" on line 
three. 

Note that the slash character and the pattern that you are searchingfor appear 
at the bottom of the screen. This bottom line is the vi status line. 



The $tatu$ line appears at the 
bottom of the screen. It is used to 
display information, including 
patterns you are searching for, line- 
oriented commands (explained later 
in this demonstration), and error 
messages. 
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For example, to get status information about the file, press CNTRL-G. Your 
screen should look like this: 



Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain [characters. 
Characters form words. 
Words form text. 

"temp" fModifiedl line 4 of 10 ~4%- 



The status line on the bottom tells you the name of the file you are editing, 
whether it has been modified, the current line number, the number of lines in 
the file, and your location in the file as a percentage of the number of lines in the 
file. The status line disappears as you continue working. 



5.2.8 Searching and Replacing 

Let's say you want to change all occurrences of "text" in the demonstration file 
to "documents". Rather than search for "text", then delete it and insert 
"documents", you can do it all in one command. The commands you have 
learned so far have all been tcreen- oriented. Commands that can perform more 
than one action (searching and replacing) are /» ne- orie nted commands. 
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Screen-oriented commands are 
executed at the location of the 
cursor. You do not need to tell the 
computer where to perform the 
operation; it takes place relative to 
the cursor. Line- oriented commands 
require you to specify an exact 
location (called an "address") where 
the operation is to take place. 
Screen-oriented commands are easy 
to type in, and provide immediate 
feedback; the change is displayed on 
the screen. Line-oriented commands 
are more complicated to type in, but 
they can be executed independent of 
the cursor, and in more than one 
place in a file at a time. 



All line-oriented commands are preceded by a colon which acts as a prompt on 
the status line. Line-oriented commands themselves are entered on this line 
and terminated with a RETURN. 



In this chapter, all instructions for 
line-oriented commands will include 
the colon as part of the command. 



To change "text" to "documents, press ESC to make sure you are in command 
mode, then type: 

:l,$s/text/documents/g 

This command means "From the first line (1) to the end of the file ($), find text 
and replace it with document$ (s/text/documents/) everywhere it occurs on 
each line (g)". 

Press RETURN. Your screen should look like this: 
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Files contain documents. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form documents. 
Files contain documents. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
[Wjords form documents. 



Note that "Text" in lines two and eight was not changed. Case is significant in 
searches. 

Just for practice, use the undo command to change "documents" back to 
"text". Press: 



Your screen now looks like this: 



[Fjiles contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



5.2.9 Leaving Vi 

All of the editing you have been doing has affected a copy of the file, and no* the 
file named temp that you specified when you invoked vi. To save the changes 
you have made, exit the editor and return to the XENIX shell, type 



Remember to press RETURN. The name of the file, and the number of lines and 
characters it contains are displayed on the status line: 
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"temp" [New file] 10 lines, 214 characters 
Then the XENIX prompt appears. 

5.2.10 Adding Text From Another File 

In this section we'll create a new file, and insert text into it from another file. 
First, create a new file named practice by typing: 

vi practice 

This file is empty. Let's copy the text from temp and put it in practice with the 
line-oriented read command. Press ESC to make sure you are in command 
mode, then type 

:r temp 

Your file should look like this: 



[FJiles contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



The text from temp has been copied and put in the current file practice. There 
is an empty line at the top of the file; Move the cursor to the empty line and 
delete it with the dd command. 



5.2.11 Leaving Vi Temporarily 

Vi allows you to execute commands outside of the file you are editing, such as 
date. To find out the date and time, type 

:!date 

Press RETURN. This displays the date, then prompts you to press RETURN to 
, reenter command mode. Go ahead and try it. Your screen should look similar 
to this: 
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Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 

:!date 

Mon Jan 9 16:33:37 PST 1984 

[Hit return to continue]. 



5.2.12 Changing Your Display 

Besides the set of editing commands described above, there are a number of 
options that can be set either when you invoke vi, or later when editing. These 
options allow you to control editing parameters such as line number display, 
and whether or not case is significant in searches. In this section we'll learn how 
to turn on line numbering, and how to look at the current option settings. 

To turn on automatic line numbering, type 

:set number 

Press RETURN. Your screen is redrawn, and line numbers appear to the left of 
the text. Your screen looks like this: 



1 


Files contain text. 


2 


Text contains lines. 


3 


Lines contain characters. 


4 


Characters form words. 


5 


Words form text. 


6 


Files contain text. 


7 


Text contains lines. 


8 


Lines contain characters. 


9 


Characters form words. 


10 


Words form text. 



You can get a complete list of the available options by typing 
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:set all 



and pressing RETURN. Setting these options is described in section 5.5 "Setting 
Up Your Environment", but it is important that you be aware of their 
existence. Depending on what you are working on, and your own preferences, 
you will want to alter the default settings for many of these options. 



5.2.13 Canceling an Editing Session 

Finally, to exit vi without saving the file practice , type: 

:q! 

and press RETURN. This cancels all the changes you have made to practice 
and, since it is a new file, deletes it. The prompt appears. If practice had 
already existed before this editing session, the changes you made would be 
disregarded, but the file would still exist. 

This completes the demonstration. You have learned how to get in and out of 
vi, insert and delete text, move the cursor around, make searches and 
replacements, how to execute line-oriented commands, copy text from other 
files, and cancel an editing session. There are many more commands to learn, 
but the fundamentals of using vi have been covered. The following sections will 
give you more detailed information about these commands and about vi's other 
commands and features. 



5.3 Editing Tasks 

The following sections explain how to perform common editing tasks. By 
following the instructions in each section you will be able to complete each task 
described. Features that are needed in several tasks are described each time 
they are used, so some information is repeated. 



5.3.1 How to Enter the Editor 

There are several ways to begin editing, depending on what you are planning to 
do. This section describes how to start, or "invoke" the editor with one 
filename. To invoke vi on a series of files, see section 5.3.24, "Editing a Series of 
Files". 



5.3.1.1 With a Filename 

The most common way to enter vi is to type "vi" and the name of the file you 
wish to edit: 
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vi filename 
If filename does not already exist, anew, empty file is created. 

5.3.1.2 At a Particular Line 

You can also enter the editor at a particular place in a file. For example, if you 
wish to start editing a file at line 100, type: 

vi +100 filename 

The cursor is placed at line 100 of filename. 

5.3.1.3 At a Particular Word 

If you wish to begin editing at the first occurrence of a particular word, type 

vi +/word filename 

The cursor is placed at the first occurrence of word. For example, to begin 
editing the file temp at the the first occurrence of "contain", type 

vi + /contain temp 



5.3.2 Moving the Cursor 

The cursor movement keys allow you to move the cursor around in a file. 
Cursor movement can only be done in command mode. 



5.3.2.1 Moving the Cursor By Characters: h,j,k,l,SPACE,BKSP 

The SPACE bar and the 1 key move the cursor forward a specified number of 
characters. The BKSP key and the h key move it backward a specified number 
of characters. If no number is specified, the cursor moves one character. For 
example, to move backward four characters, type 

4h 

You can also move the cursor to a designated character on the current line. F 
moves the cursor back to the specified character, f moves it forward. The cursor 
rests on the specified character. For example, to move the cursor backward to 
the nearest p on the current line, type: 

Fp 
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To move the cursor forward to the nearest p, type: 

f P 

The T and t keys work the same way as f and F, but place the cursor 
immediately before the specified character. For example, to move the cursor 
back to the space next to the nearest p in the current line, type 

Tp 

If the pwere in the word telephone, the cursor would sit on the A. 

• The cursor always remains on the same line when you use these commands. If 
you specify a number greater than the number of characters on the line, the 
cursor does not move beyond the beginning or end of that line. 

5.3.2.2 Moving the Cursor by Words: w, W, b, B, e, E 

The w key moves the cursor forward to the beginning of the specified number of 
words. Punctuation and nonalphabetic characters (such as 
!§#$%'&*()_+{}[]'IV<>/) are considered words, so if a word is followed by 
a comma the cursor will count the comma in the specified number. For 
example, if the cursor rests on the first letter of the sentence 

No, I didn't know he had returned, 
and you press 

6w 

the cursor stops on the k in know. 

W works the same way as w, but includes punctuation and nonalphabetic 
characters as part of the word. Using the above example, if you press 

6W 

the cursor stops on the r in returned] the comma and the apostrophe are 
included in their adjacent words. 

The e and £ keys move the cursor forward to the end of a specified number of 
words. The cursor is placed on the last letter of the word. The e command 
counts punctuation and nonalphabetic characters as separate words; E does 
not. 

B and b move the cursor back to the beginning of a specified number of words. 
The cursor is placed on the first letter of the word. The b command counts 
punctuation and nonalphabetic characters as separate words; B does not. Using 
the above example, if the cursor is on the rin returned, type 
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4b 
and the cursor moves to the t in didn 't. Type 

4B 

, and the cursor moves to the first if in didn 't. 

The w,W,b and B commands will move the cursor to the next line if that is 
where the designated word is, unless the current line ends in a space. 

5.3.2.3 Moving the Cursor by Lines 

Forward: j, CNTRL-N, +, RETURN, LINEFEED,! 

The RETURN, LINEFEED and + keys move the cursor forward a specified 
number of lines, placing the cursor on the first character. For example, to move 
the cursor forward six lines, type 

6+ 

The j and CNTRL-N keys move the cursor forward a specified number of lines. 
The cursor remains in the same place on the line, unless there is no character in 
that place, in which case it moves to the last character on the line. For example, 
in the following two lines if the cursor is resting on the e in charade re, pressing 
"j" moves it to the period at the end of the second line: 

Lines contain characters. 
Text contains lines. 

The dollar sign($) moves the cursor to the end of a specified number of lines. For 
example, to move the cursor to the last character of the line four lines down 
from the current line, type: 

4$ 

Backward : k, CNTRI^P 

CNTRL-P and k move the cursor backward a specified number of lines, keeping 
it on the same place on the line. For example, to move the cursor backward four 
lines from the current line, type 

4k 

5.3.2.4 Moving the Cursor on the Screen: H, M, L 

The H, M and L keys move the cursor to the beginning of the top, middle and 
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bottom lines of the screen, respectively . 

5.3.3 Moving Around in a File: Scrolling 

The following commands move the file so different parts can be displayed on the 
screen. The cursor is placed on the first letter of the last line scrolled. 

5.3.3.1 Scrolling Up Part of the Screen: CNTRL-U 

CNTRL-U scrolls up one-half screen. 

5.3.3.2 Scrolling Up the Full Screen: CNTRL-B 

CNTRL-B scrolls up a full screen. 

5.3.3.3 Scrolling Down Part of the Screen: CNTRL-D 

CNTRL-D scrolls down one-half screen. 

5.3.3.4 Scrolling Down a Full Screen: CNTRL-F 

CNTRL-F scrolls down a full screen. 

5.3.3.5 Placing a Line at the Top of the Screen: z 
To scroll the current line to the top of the screen, press 



then press RETURN. To place a specific line at the top of the screen, precede the 
"z" with the line number, as in 

33z 

Press RETURN, and line 33 scrolls to the top of the screen. For information on 
how to display line numbers, see section 5.5.5, "Displaying Line Numbers: 
number". 



5.3.4 Inserting Text Before the Cursor: i and I 

You can begin inserting text before the cursor anywhere on a line, or at the 
beginning of a line. In order to insert text into a file, you must be in "insert 
mode". To enter insert mode press 
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The "i" does not appear on the screen. Any text typed after the "i" becomes 
part of the file you are editing. To leave insert mode and reenter command 
mode, press ESC. For more explanation of modes in vi, see section 5.2.2, 
"Inserting Text". 



5.3.4.1 Anywhere on a Line: i 

To insert text before the cursor, use the i command. Press the i key to enter 
insert mode (the i does not appear on your screen), then begin typing your text. 
To leave insert mode and reenter command mode, press ESC. 



5.3.4.2 At the Beginning of the Line: I 

Using an uppercase I to enter insert mode also moves the cursor to the 
beginning of the current line. It is used to start an insertion at the beginning of 
the current line. 



5.3.5 Appending After the Cursor: a and A 

You can begin appending text after the cursor anywhere on a line, or at the end 
of aline. Press ESC to leave insert mode and reenter command mode. 



5.3.5.1 Anywhere on a Line: a 

To append text after the cursor, use the a command. Press the a key to enter 
insert mode (the "a" does not appear on your screen), then begin typing your 
text. Press ESC to leave insert mode and reenter command mode. 



5.3.5.2 At the end of a Line: A 

Using an uppercase A to enter insert mode also moves the cursor to the end of 
the current line. It is useful for appending text at the end of the current line. 



5.3.6 Correcting Typing Mistakes 

If you make a mistake while you are typing, the simplest way to correct it is 
with the BKSP key. Backspace across the line until you have backspaced over 
the mistake, then retype the line. You can only do this, however, if the cursor is 
on the same line as the error. See sections 5.3. 12 through 5.3.15 for other ways 
to correct typing mistakes. 
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5.3.7 Opening a New Line 

To open a new line above the cursor, press 0. To open a new line below the 
cursor, press o. Both commands place you in insert mode, and you may begin 
typing immediately. Press ESC to leave insert mode and reenter command 
mode. 

You may also use the RETURN key to open new lines above and below the 
cursor. To open a line above the cursor, move the cursor to the beginning of the 
line, press i to enter insert mode, then press RETURN. (For information on how 
to move the cursor, see section 5.3.2, "Moving the Cursor".) To open a line 
below the cursor, move the cursor to the end of the current line, press i to enter 
insert mode, then press RETURN. 



5.3.8 Repeating the Last Insertion 

CNTRL-® repeats the last insertion. Press "i" to enter insert mode, then press 

CNTRL-®. 

CNTRL-® only repeats insertions of 128 characters or less. If more than 128 
characters were inserted, CNTRL-® does nothing. 

For other methods of repeating an insertion, see section 5.3.8, "Repeating the 
Last Insertion", section 5.3.9, "Inserting Text From Other Files", and section 
5.3.22, "Repeating a Command". 



5.3.0 Inserting Text From Other Files 

To insert the contents of another file into the file you are currently editing, use 
the read command. Move the cursor to the line immediately above the place 
you want the new material to appear, then type 

:r filename 

where filename is the file containing the material to be inserted, and press 
RETURN. The text of filename appears on the line below the cursor, and the 
cursor moves to the first character of the new text. This text is a copy; the 
original filename still exists. 

Inserting selected lines from another file is more complicated. The selected lines 
are copied from the original file into a temporary holding place called a 
"buffer", then inserted into the new file. 



To select the lines to be copied, save your original file with the write 
command (:w), but do not exit vi. 
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2. Type 

:e filename 

where filename is the file that contains the text you want to copy, and 
press RETURN. 

3. Move the cursor to the first line you wish to select. 

4. Type 

mk 

This "marks" the first line of text to be copied into the new file with 
the letter "k". 

5. Move the cursor to the last line of the selected text. Type 

"ay'k 

The lines from your first "mark" to the cursor are placed, or 
"yanked" into buffer a. They will remain in buffer a until you replace 
them with other lines, or until you exit the editor. 

6. Type 

:c# 

to return to your previous file. (For more information about this 
command, see section 5.3.25, "Editing a New File Without Leaving 
the Editor".) Move the cursor to the line above the place you wantthe 
new text to appear, then type 

"ap 

This "puts" a copy of the yanked lines into the file, and the cursor is 
placed on the first letter of this new text. The buffer still contains the 
original yanked lines. 

You can have 26 buffers named a, b, c, up to and including z. To name and select 
different buffers, replace the a in the above examples with whatever letter you 
wish. 

You may also delete text into a buffer, then insert it in another place. For 
information on this type of deletion and insertion, see section 5.3.17, "Moving 
Text". 
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5.3.9.1 Copying Lines From Elsewhere in the File 

To copy lines from one place in a file to another place in the same file, use the co 
(copy) command. 

Co is a line-oriented command, and to use it you must know the line numbers of 
the text to be copied and its destination. To find out the number of the current 
line type 

:nu 



and press RETURN. The line number and the text of that line are displayed on 
the status line. To find out the destination line number, move the cursor to the 
line above where you want the copied text to appear and repeat the :nu 
command. You can also make line numbers appear throughout the file with the 
linenumber option. For information on how to set this option, see section 5.5.5, 
"Displaying Line Numbers: number". The following example uses the 
linenumberoption. 



1 [FJiles contain text. 

2 Text contains lines. 

3 Lines contain characters. 

4 Characters form words. 

5 Words form text. 



Using the above example, to copy lines 3 and 4 and put them between lines 1 and 
2, type 

:3,4 co 1 

The result is: 
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1 Files contain text. 

2 Lines contain characters. 

3 [Characters form words. 

4 Text contains lines. 

5 Lines contain characters. 

6 Characters form words. 

7 Words form text. 



If you have text that is to be inserted several times in different places, you can 
save it in a temporary storage area, called a "buffer", and insert it whenever it 
is needed. For example, to repeat the first line of the following text after the last 
line: 



[Fjiles contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



1. Move the cursor over the Fin Filee. Type the following line, which 
will not be echoed on your screen: 

"ayy 

This "yanks" the first line into buffer a. Move the cursor over the W 
in Word$. 

2. Type the following line: 

"ap 

This "puts" a copy of the yanked line into the file, and the cursor is 
placed on the first letter of this new text. The buffer still contains the 
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original yanked line. 
Your screen looks like this: 



Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 
[Fjiles contain text. 



If you wish to "yank" several consecutive lines, indicate the number of lines you 
wish to yank after the name of the buffer. For example, to place three lines from 
the above text in the "a" buffer, type 

"a3yy 

For another method of placing text in a buffer, and more information about 
naming buffers, see section 5.3.9, "Inserting Text From Other Files". 



5.3.10 Inserting Control Characters into Text 

Many control characters have special meaning in vi, even when typed in insert 
mode. To remove their special significance, press CNTRL-V before typing the 
control character. Note that CNTRL-J, CNTRL-Q, and CNTRL-S cannot be 
inserted as text. CNTRL-J is a newline character. CNTRL-Q and CNTRL-S are 
meaningful to the operating system, and are trapped by it before they are 
interpreted by vi. 



5.3.11 Joining and Breaking Lines 

To join two lines press 

J 

while the cursor is on the first of the two linesyou wish to join. 

To break one line into two lines, position the cursor on the space preceding the 
first letter of what will be the second line, press 
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r 
then press RETURN. 

5.3.12 Deleting a Character: x and X 

The x and X commands delete a specified number of characters. The x 
command deletes the character above the cursor; the X command deletes the 
character immediately before the cursor. If no number is given, one character is 
deleted. For example, to delete three characters following the cursor (including 
the character the above the cursor), type: 

3x 

To delete three characters preceding the cursor, type: 
3X 



5.3.13 Deleting a Word: dw 

The dw command deletes a specified number of words. If no number is given, 
one word is deleted. A word is interpreted as numbers and letters separated by 
whitespace. When a word is deleted, the space after it is also deleted. For 
example, to delete three words, type: 

3dw 



5.3.14 Deleting a Line: D and dd 

The D command deletes all text following the cursor on that line, including the 
character the cursor is resting on. The dd command deletes a specified number 
of lines and closes up the space. If no number is given, only the current line is 
deleted. For example, to delete three lines, type: 

3dd 

Another way to delete several lines is to use a line-oriented command. To use 
this command it helps to know the line numbers of the text you wish to delete. 
For information on how to display line numbers, see section 5.5.5, "Displaying 
Line Numbers: number". 

For example, to delete lines 200 through 250, type 

:200,250d 

Press RETURN. When the command finishes, the message 
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50 lines 

appears on the vi status line, indicating how many lines were deleted. 

It is possible to remove lines without displaying line numbers using shorthand 
"addresses". For example, to remove all lines from the current line (the line the 
cursor rests on) to the end of the file, type 

:.,ld 

The dot (.) represents the current line, and the dollar sign stands for the last line 
in the file. To delete the current line and 3 lines following it, type 

:.,+3d 

To delete the current line and 3 lines preceding it, type 

:.,-3d 

For more information on using addresses in line-oriented commands, see «t(C) 
in the XENIX Refere nee Manual. 

5.3.15 Deleting an Entire Insertion 

If you wish to delete all of the text you just typed, press CNTRL-U while you are 
in insert mode. The cursor returns to the beginning of the insertion. The text of 
the original insertion is still displayed, and any text you type replaces it. When 
you press ESC, any text remaining from the original insertion disappears. 

5.3.16 Deleting and Replacing Text 

Several vi commands combine removing characters and entering insert mode. 
The following sections explain how to use these commands. 

5.3.16.1 Overstriking: r and R 

The r command replaces the character under the cursor with the next 
character typed. To replace the character under the cursor with a "b", for 
example, type: 

rb 

If a number is given before r, that number of characters is replaced with the 
next character typed. For example, to replace the character above the cursor, 
plus the next three characters, with the letter "b", type 



5-28 



Vi: A Text Editor 



4rb 



Note that you now have four "b"s in a row. 



The R command replaces as many characters as you type, up to the end of the 
line. To end the replacement, press ESCAPE. For example, to replace the 
second line in the following text with "Spelling is important.": 



Files contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



Move the cursor over the Tin Text. Press R, then type 

Spelling is important. 

Press ESC to end the replacement. If you make a mistake, use the BKSP key to 
correct it. Your screen should now look like this: 



Files contain text. 
Spelling is importantj.] 
Lines contain characters. 
Characters form words. 
Words form text. 



5.3.16.2 Substituting: s and S 

The s command replaces a specified number of characters, beginning with the 
character under the cursor, with text you type in. For example, to substitute 
xyz for the cursor and two characters following it, type: 
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3sxyz 



The S command deletes a specified number of lines and replaces them with text 
you type in. You may type in as many new lines of text as you wish; S affects 
only how many lines are deleted. If no number is given, one line is deleted. For 
example, to delete four lines, including the current line, type: 

4S 

This differs from the R command. The S command deletes the entire current 
line; the R command deletes text from the cursor onward. 



5.3.16.3 Replacing a Word: cw 

The cw command replaces a word with text you type in. For example, to 
replace the word bear with the word fox, move the cursor over the b in bear. 
Press 



A dollar sign appears after the r in bear, marking the end of the text that is 
being replaced. Type 

fox 

and press RETURN. The rest of be ar disappears and only fox remains. 

5.3.16.4 Replacing the Rest of a Line: C 

The C command replaces text from the cursor to the end of the line. For 
example, to replace the text of the sentence 

Who's afraid of the big bad wolf? 

from big to the end, move the cursor over the b in big and press 

C 

A dollar sign ($) replaces the question mark (?) at the end of the line. Type the 
following: 

little lamb? 

Press ESC. The remaining text from the original sentence disappears. 



5-30 



Vi: A Text Editor 



5.3.16.5 Replacing a Whole Line: cc 

The cc command deletes a specified number of lines, regardless of the location 
of the cursor, and replaces them with text you type in. If no number is given, the 
current line is deleted. 



5.3.16.6 Replacing a Particular Word on a Line 

If a word occurs several times on one line, it is often convenient to use a line- 
oriented command to replace it. For example, to replace the word removing 
with deleting'inthe following sentence: 

In vi, removing a line is as easy as removing a letter. 

Make sure the cursor is at the beginning of that line, and type 

:s/removing/deleting/g 

Press RETURN. This line-oriented command means "Substitute (s) for the 
word re moving the word deleting, everywhere it occurs on the current line (g)". 
If you don't include a g at the end, only the first occurrence of removing is 
changed. 

For more information on using line-oriented commands to replace text, see 
section 5.3. 19, "Searching and Replacing". 

5.3.17 Moving Text 

To move a block of text from one place in a file to another, you can use the line- 
oriented m command. You must know the line numbers of your file to use this 
command. The line number option displays line numbers. To set this option, 
press ESC to make sure you are in command mode, then type: 

set linenumber 

Line numbers will appear to the left of your text. (For more information on 
setting the line-number option, see section 5.5.5, "Displaying Line Numbers: 
number".) 

The following example uses the linenumber option. For other ways to display 
line numbers, see section 5.3.29, "Finding Out What Line You're On". 
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1 [Fjiles contain text. 

2 Text contains lines. 

3 Lines contain characters. 

4 Characters form words. 

5 Words form text. 



To insert lines 2 and 3 between lines 4 and 5, type 

:2,3m4 
Your screen should look like this: 



1 Files contain text. 

2 Characters form words. 

3 Text contains lines. 

4 Lines contain characters. 

5 [Wjords form text. 



To place line 5 after line 2, type 
:5m2 
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After moving, your screen should look like this: 



1 Files contain text. 

2 Characters form words. 

3 [W]ords form text. 

4 Text contains lines. 

5 Lines contain characters. 



To make line 4 the first line in the file, type 

:4m0 
Your screen should look like this: 



1 (Tjext contains lines. 

2 Files contain text. 

3 Characters form words. 

4 Words form text. 

5 Lines contain characters. 



You can also delete text into a temporary storage place, called a "buffer", and 
insert it wherever you wish. When text is deleted it is placed in a "delete 
buffer". There are nine "delete buffers". 

The first buffer always contains the most recent deletion. In other words, the 
first deletion in a given editing session goes into buffer 1. The second deletion 
also goes into buffer 1, and pushes the contents of the old buffer 1 into buffer 2. 
The third deletion goes into buffer 1, pushing the contents of buffer 2 into buffer 
3, and the contents of buffer 1 into buffer 2. When buffer 9 has been used, the 
next deletion pushes the current text of buffer 9 off the stack and it disappears. 

Text remains in the delete buffers until it is pushed off the stack, or until you 
quit the editor, so it is possible to delete text from one file, change files without 
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leaving the editor, and place the deleted text in another file. 

Delete buffers are particularly useful when you wish to remove text, store it, 
and put it somewhere else. Using the following text as an example 



[Fjiles contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



Delete the first line by typing 

dd 

Delete the third line the same way. Now move the cursor to the last line in the 
example and press 

"IP 
The line from the #«c on <f deletion appears: 



Text contains lines. 
Characters form words. 
Words form text. 
[Ljines contain characters. 



Now type: 
"2p 
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The line from the firet deletion appears: 



Text contains lines. 
Characters form words. 
Words form text. 
Lines contain characters. 
[Fjiles contain text. 



Inserting text from a delete buffer does not remove the text from the buffer. 
Since the text remains in a buffer until it is either pushed off the stack or until 
you quit the editor, you may use it as many times as you wish. 

It is also possible to place text in named buffers. For information on how to 
create named buffers, see section 5.3.9, "Inserting Text From Other Files". 



5.3.18 Searching: / and ? 

You can search forward and backward for patterns in vi. To search forward, 
press the slash (/) key. The slash appears on the status line. Type the characters 
you wish to search for. Press RETURN. If the specified pattern exists, the cursor 
will move to the first character of the pattern. For example, to search forward 
in the file for the word account, type: 

/account 

Press RETURN. The cursor is placed on the first character of the pattern. To 
place the cursor at the beginning of the line above ae count, tor example, type 

/account/- 

To place the cursor at the beginning of the line two lines above the line that 
contains account, type 

/account/-2 
To place the cursor two lines below account, type 

/account/+2 
To search backward through a file, use ? instead of / to start the search. For 
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example, to find all occurrencesof account above the cursor, type: 

?account 

To search for a pattern containing any of the special characters {. * \ [ J $ and 
*), each special character must be preceded by a backslash. For example, to find 
the pattern U.S. A. t type: 

/U\.S\.A\./ 

You can continue to search for a pattern by pressing 



after each search. The pattern is unaffected by intervening vi commands, and 
you can use n to search for the pattern until you type in a new pattern or quit 
the editor. 

Vi searches for exactly what you type. If the pattern you are searching for 
contains an uppercase letter (for example, if it appears at the beginning of a 
sentence), vi ignores it. To disregard case in a search command, you can set the 
ignorecase option: 

:set ignorecase 

By default, searches "wrap around" the file. That is, if a search starts in the 
middle of a file, when vi reaches the end of the file it will "wrap around" to the 
beginning, and continue until it returns to where the search began. Searches 
will be completed faster if you specify forward or backward searches, 
depending on where you think the pattern is. 

If you do not want searches to wrap around the file, you can change the 
"wrapscan" option setting. Type: 

:set nowrapscan 

and press RETURN to prevent searches from wrapping. For more information 
about setting options, see section 5.5, "Setting Up Your Environment". 



5.3.10 Searching and Replacing 

The search and replace commands allow you to perform complex changes to a 
file in a single command. Learning how to use these commands is a must for the 
serious user of vi. 

The syntax of a search and replace command is: 

g/patternl/s/[pattcrn£l/[optione\ 
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Brackets indicate optional parts of the command line. The g tells the computer 
to execute the replacement on every line in the file. Otherwise the replacement 
would occur only on the current line. The options are explained in the following 
sections. 

To explain these commands we will use the example file from the demonstration 
run: 



[Fjiles contain text. 
Text contains lines. 
Lines contain characters. 
Characters form words. 
Words form text. 



5.3.19.1 Replacing a Word 

To replace the word contain with the word are throughout the file, type the 
following command: 

:g/contain /s//are /g 

This command says"On each line of the file (g), find contain and substitute for 
that word (s//) the word are, everywhere it occurs on that line (the second g)". 
Note that a space is included in the search pattern for contain] without the 
space contain* would also be replaced. 

After the command executes your screen should look like this: 
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[FJiles are text. 
Text contains lines. 
Lines are characters. 
Characters form words. 
Words form text. 



5.3.10.2 Printing all Replacements 

To replace contain with are throughout the file, then print every line changed, 
use the p option: 

:g/contain /s//are /gp 

Press RETURN. After the command executes, each line in which contain was 
replaced by arc is printed on the lower part of the screen. To remove these lines, 
redraw the screen by pressing CNTRL-L 



5.3.10.3 Choosing a Replacement 

Sometimes you may not want to replace every instance of a given pattern. The 
c option displays every occurrence of pattern and waits for you to confirm that 
you want to make the substitution. If you press y the substitution takes place; if 
you press RETURN the next instance of pattern is displayed. 

To run this command on the example file, type 

:g/contain/s//are/gc 
Press RETURN. The first instance of contain appears on the status line: 

Files contain text. 
Press y, then RETURN. The next occurrence of contain appears. 

5.3.20 Pattern Matching 

Search commmands often require, in addition to the characters you want to 
find, a context in which you want to find them. For example, you may want to 
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locate every occurrence of a word at the beginning of a line. Vi provides several 
special characters that specify particular contexts. 



5.3.20.1 Matching the Beginning of a Line 

When a caret(') is placed at the beginning of a pattern, only patterns found at 
the beginning of a line are matched. For example, the following search pattern 
only finds text when it occurs as the first word on a line: 

/ A text/ 

To search for a caret that appears as text you must precede it with a backslash 
(\). 



5.3.20.2 Matching the End of a Line 

When a dollar sign ($) is placed at the end of a pattern, only patterns found at 
the end of a line are matched. For example, the following search pattern only 
finds text when it occurs as the last word on a line: 

/text$/ 

To search for a dollar sign that appears as text you must precede it with a 
backslash (\). 



5.3.20.3 Matching Any Single Character 

When used in a search pattern, the period (.) matches any single character 
except the newline character. For example, to find all words that end with ed, 
use the following pattern: 

/.ed / 

Note the space between the d and the backslash. 

To search for a period in the text, you must precede it with a backslash (\). 

5.3.20.4 Matching a Range of Characters 

A set of characters enclosed in square brackets matches any single character in 
the range designated. For example, the search pattern 

finds any lowercase letter. The search pattern 
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/[aAjpple/ 

finds all occurrences of apple and Apple. 

To search for a bracket that appears as text, you must precede it with a 
backslash (\). 

5.3.20.5 Matching Exceptions 

A caret ( A ) at the beginning of string matches every character except those 
specified in string. For example the search pattern 

finds anything but a lowercase letter or a newline. 

5.3.20.6 Matching the Special Characters 

To place a caret, hyphen or square bracket in a search pattern, precede it with a 
backslash. To search for a caret, for example, type: 

A7 

If you need to search for many patterns that contain special characters, you can 
reset the magic option. To do this, type 

:nomagic 

This removes the special meaning from the characters ., \, $, [ and ]. You can 
include them in search and replace commands without a preceding backslash. 
Note that the special meaning cannot be removed from the special characters 
star (*) and caret (* ); these must always be preceded by a backslash in searches. 

To restore magic, type 

:set magic 

For more information about setting options, see section 5.5, "Setting Up Your 
Environment". 



5.3.21 Undoing a Command: u 

Any editing command can be reversed with the "undo" command. Undo 
works on both screen-oriented and line-oriented commands. For example, if 
you have deleted a line and then decide you wish to keep it, press u and the line 
will reappear. Use the following line as an example: 
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[TJext contains lines. 



Place the cursor over the e in contain*, then delete the word with the dw 
command. Your screen should look like this: 



Text (l)ines. 



Press uto undo the dw command. Contain* reappears: 




If you press u again, contain* is deleted again: 
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Text [ljines. 



It is important to remember that u only undoes the last command. For 
example, if you make a global search and replace, then delete a few characters 
with the x command, pressing u will undo the deletions but not the global 
search and replace. 



5.3.22 Repeating a Command: • 

Any screen-oriented vi command can be repeated with the repeat (.) 
command. For example, if you have deleted two words by typing: 

2dw 

you may repeat this command as many times asyou wish by pressing the period 
key (.). Cursor movement does not affect the repeat command, so you may 
repeat a command as many times and in as many places in a file asyou wish. 

The repeat command only repeats the last vi command. Careful planning can 
save time and effort. For example, if you want to replace a word that occurs 
several times in a file (and for some reason you do not wish to use a global 
command), use the cw command instead of deleting the word with the dw 
command, then inserting new text with the i command. By using the cw 
command you can repeat the replacement with the dot (..) command. If you 
delete the word, then insert new text, dot only repeats the replacement. 



5.3.23 Leaving the Editor 

There are several ways to exit the editor and save any changes you may have 
made to the file. One way is to type: 

and press RETURN. This command replaces the old copy of the file with the 
new one you have just edited, quits the editor, and returns you to the XENIX 
shell. Similarly, if you type 
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ZZ 

, the same thing happens, except the old copy file is written out only it you have 
made any changes. Note that the ZZ command is not preceded by a colon, and 
is not echoed on the screen. 

To leave the editor without saving any changes you have made to the file, type 

:q! 

The exclamation point tells vi to quit unconditionally. If you leave out the 
exclamation point: 

:q 

vi will not let you quit. You will see the error message: 

No write since last change (:quit! overrides) 

This message tells you to use ":q!" if you really want to leave the editor without 
saving your file. 

5.3.23.1 Saving a File Without Leaving the Editor 

There are many occasions when you must save a file without leaving the editor, 
such as when starting a new shell, or moving to another file. Before you can 
perform these tasks you must first save the current file with the write 
command: 



You do not need to type the name of the file; vi remembers the name you used 
when you invoked the editor. If you invoked vi without a filename, you may 
name the file by typing 

:w filename 

where filename is the name of the new file. 

5.3.24 Editing a Series of Files 

Entering and leaving vi for each new file takes time/particularly on a heavily 
used system, or when you are editing large files. If you have many files to edit in 
one session, you can invoke vi with more than one filename, and thus edit more 
than one file without leaving the editor, as in: 

vi filel file2 file3 file4 file5 file6 
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But typing out many filenames is tedious, and you may make a mistake. If you 
mistype a filename, you must either backspace over to mistake and retype the 
line, or kill the whole line and retype it. It is more convenient to invoke vi using 
the special characters as abbreviations. 

To invoke vi on the above files without typing each name, type: 

vi file* 

This invokes vi on all files that begin with the letters JUe. You can plan your 
filenames to save time in later editing. For example, if you are writing a 
document that consists of many files, it would be wise to give each file the same 
filename extension, such as ".s". Then you can invoke vi on the entire 
document: 

vi *.s 
You can also invoke vi on a selected range of files: 

vi [3-5]*.s 
or 

vi (a-h|* 
To invoke vi on all files that are five letters long, and have any extension: 

vi ?????.* 

For more information on using special characters, see Chapter 3 of this manual, 
section 3.3.4, "Special Characters". 

When you invoke vi with more than one filename, you will see the following 
message when the first file is displayed on the screen: 

x files to edit 

After you have finished editing a file, save it with the write command (: w), then 
go to the next file with the next command: 



The next file appears, ready to edit. It is not necessary to specify a filename; the 
files are invoked in alphabetical (or numerical, if the filenames begin with 
numbers) order. 

If you forget what filesyou are editing, type: 

:args 
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The list of files appears on the status line. The current file is enclosed in square 
brackets. 

To edit a file out of order, such as file 4 after file 2, type 

:e file4 
instead of using the next command. If you type: 

:n 
after you finish editing/t/e^,you will go back to fileS. 
If you wish to start again from the beginning of the list, type: 

:rew 
To discard the changesyou made and start again at the beginning, type: 

:rew! 

5.3.25 Editing a New File Without Leaving the Editor 

You can start editing another file anywhere on the XENIX system without 
leaving vi. This saves time when you wish to edit several files in one session that 
are in different directories, or even in the same directory. For example, if you 
have finished editing /u$r/ joe/memo and you wish to edit /u$r/mary/ letter, 
first save the file me mo with the w command (:w), then type: 

:e /usr/mary /letter 

/uer/mary/ letter appears on your screen just as though you had left vi. 



Note 



You muet write out your file with the write command (:w) if you 
want to save the changes you have made. If you try to edit a second 
file without writing out the first file, the message "No write since last 
change (:e! overrides)" appears. If you use :e! all your changes to the 
first file are discarded. 



If you want to switch back and forth between two files, vi remembers the name 
of the last file edited. Using the above example, if you wish to go back and edit 
the file /usr/joe/me mo after you have finished with /usr/mary /letter, type 
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:e# 



The cursor is positioned in the same location it was when you first saved 
fu$r/ joe/ memo. 



5.3.26 Leaving the Editor Temporarily: Shell Escapes 

You can execute any XENIX command from within vi using the shell "escape" 
(as in, "escape from vi") command, !. For example, if you wish to find out the 
date and time, type: 

:!date 

The exclamation point sends the remainder of the line to the shell to be 
executed, and the date and time appear on the vi status line. You can use the ! 
to perform any XENIX command. To send mail to joe without leaving the 
editor, type 

:!mail joe 

Type your message and send it. (For more information about the XENIX mail 
system, see Chapter 6, "Mail".) After you send it, the message 

(Hit return to continue] 

appears. Press RETURN to continue editing. 

If you want to perform several XENIX commands before returning to the editor, 
you can invoke a new shell: 

:!sh 

The XENIX prompt appears. You may execute as many commands as you like. 
Press CNTRL-D to terminate the new shell and return to your file. 

If you have not written out your file before a shell escape, you will see the 
message: 

[No write since last change} 

It is a good idea to save your file with the write command (:w) before executing 
an escape, just in case something goes wrong. However, once you become an 
experienced vi user, you may wish to turn off this message. To turn off the "No 
write" message, reset the warn option, as follows: 

:set nowarn 

For more information about setting options in vi, see section 5.5, "Setting Up 
Your Environment". 
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5.3.27 Performing a Series of Line-Oriented Commands: Q 

If you have several line-oriented commands to perform, you can place yourself 
temporarily in line-oriented mode by typing 

Q 

while you are in command mode. A colon prompt appears on the status line. 

Commands executed in this mode cannot be undone with the u command, nor 
do they appear on the screen until you re-enter normal vi mode. To re-enter 
normal vi mode, type 

vi 



5.3.28 Finding Out What File You're In 

If you forget what file you are editing, press CNTRL-G while you are in 
command mode. A line similar to the following appears appears on the status 
line: 

"memo" [Modified] line 12 of 100 -12%-- 

From left to right, the following information is displayed: 

— The name of the file 

— Whether or not the file has been modified 

— The line number the cursor is on 

— How many lines there are in the file 

— Your location in the file (expressed as a percentage) 

This command is also useful when you need to know the line number of the 
current line for a line-oriented command. 

The same information can be obtained by typing 

:fiie 
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5.3.20 Finding Out What Line You're On 

To find out what line of the file you are on, type 

:nu 

and press RETURN. This command displays the current line number and the 
text of the line. 

To display line numbers for the entire file, see section 5.5.5, "Displaying Line 
Numbers: number" 

5.4 Solving Common Problems 

The following is a list of common problems that you may encounter when using 
vi, along with the probable solution. 

— I don't know which mode I'm in. 

Press ESC until the bell rings. When the bell rings you are in 
command mode. 

— Ican'tgetoutofasubshell. 

Press CNTRL-D to exit any subshell. If you have created more than 
one subshell (not a good idea, usually), keep pressing CNTRL-D until 
you see the message: 

[Hit return to continue] 

— I made an inadvertent deletion (or insertion). 
Press "u" to undo the last delete Or insert command. 

— There are extra characters on my screen. 
Press CNTRL-L to redraw the screen. 

— WhenI type, nothing happens. 

Vi has crashed and you are now in the shell with your terminal 
characteristics set incorrectly. To reset the keyboard, slowly type: 

stty sane 

then press CNTRL-J or LINEFEED. Pressing CNTRL-J instead of 
RETURN is important here, since it is quite possible that the RETURN 
key will not work as a newline character. To make sure that other 
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terminal characteristics have not been altered, log off, turn your 
terminal off, turn your terminal back on, and then log back in. This 
should guarantee that your terminal's characteristics are back to 
normal. This procedure may vary somewhat depending on the 
terminal. 

— The system crashed while I was editing. 

Normally, vi will inform you (by sending you mail) that your file has 
been saved before a crash. The file can be recovered by typing 

vi -r filename 

If vi was unable to save the file before the crash, it is irretrievably lost. 

— I keep getting a colon on the status line when I press RETURN 

You are in line-oriented command mode. Type 

vi 
to return to normal vi command mode. 

— I get the error message "Unknown terminal type [Using open 
mode]" when I invoke vi. 

Your terminal type is not set correctly. To leave open mode, press 
ESC, then type 

:wq 

and press RETURN. Turn to section 5.5.1, "Setting the Terminal 
Type" for information on how to set your terminal type correctly. 



5.5 Setting Up Your Environment 

There are a number of options that can be set that affect your terminal type, 
how files and error messages are displayed on your screen, and how searches are 
performed. These options can be set with the set command while you are 
editing, or they can be placed in the vi startup file, .exre. (The .exre file is 
explained in section 5.5.13.) The following sections describe the most 
commonly used options and how to set them. There is a complete list of options 
in »i(C) in the XENIX Reference Manual. 



5.5.1 Setting the Terminal Type 

Before you can use vi, you must set the terminal type, if this has not already 
been done for you, by defining the TERM variable in your .profile file. (The 
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.profile file is explained in the XENIX Uter'$ Guide.) The TERM variable is a 
number that tells the operating system what type of terminal you are using. To 
determine this number you must find out what type of terminal you are using. 
Then look up this type in Terminals(M) in the XENIX Reference Manual. If you 
cannot find your terminal type or its number, consult your System 
Administrator. 

For these examples, we will suppose that you are using an HP 2621 terminal. 
For the HP 2621, the TERM variable is "2621". How you define this variable 
depends on which shell you are using. You can usually determine which shell 
you are using by examining the prompt character. The Bourne shell prompts 
with a dollar sign ($); the C-shell prompts with a percent sign (%). 



5.5.1.1 Setting the TERM variable: The Visual Shell 

If you are using the Visual Shell the terminal type has already been set, and you 
do not need to change it. 



5.5.1.2 Setting the TERM variabie:The Bourne Shell 

To set your terminal type to 2621 place the following commands in the file 

.profile: ( 1 

TERM=2621 
export TERM 



5.5.1.3 Setting the TERM variable: The C Shell 

To set your terminal type to 2621 for the C shell, place the following command 
in the file .login: 

setenv TERM 2621 



5.5.2 Setting Options: The set Command 

The set command is used to display option settings and to set options. 

5.5.2.1 Listing the Available Options 

To get a list of the options available to you and how they are set, type 

:set all 
Your display should look similar to this: 
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noautoindent 


open 


noslowopen 


autoprint 


nooptimize 


tabstop=8 


noautowrite 


paragraphs=IPLPPPQPP LIbp 


taglength=0 


nobeautify 


noprompt 


ttytype=»M9 


directory=/tmp 


noreadorily 


term=hl9 


noerrorbells 


redraw 


noterse 


hardtabs— 8 


report=5 


warn 


noignorecase 


scroll=4 


window=8 


nolisp 


sections=NHSHH HU 


wrapscan 


nolist 


shell s=/bin/sh 


wrapmargin=0 


magic 


shiftwidth=8 


nowriteany 


nonumber 


noshowmatch 





This chapter discusses only the most commonly used options. For information 
about the options not covered in this chapter, see vi(C) in the XENIX Reference 
Manual. 



5.5.2.2 Setting an Option 

To set an option, use the set command. For example, to set the ignoreca.ee 
option so that case is not ignored in searches, type 

:set noignorecase 



5.5.3 Displaying Tabs and End-of-Line: list 

Litt causes the "hidden" characters and end-of-line to be displayed. The 
default setting is nolist. To display these characters, type 

:set list 

Your screen is redrawn. The dollar sign ($) represents end-of-line and control-I 
( A I) represents the tab character. 



5.5.4 Ignoring Case in Search Commands: ignorecase 

By default, case is significant in search commands. To disregard case in 
searches, type 

:set ignorecase 

To change this option, type 

:set noignorecase 
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5.5.5 Displaying Line Numbers: number 

It is often useful to know the line numbers of a file. To display these numbers, 
type: 

:set number 

This redraws your screen. Numbers appear to the left of the text. To remove 
line numbers, type: 

:set nonumber 



5.5.6 Printing the Number of Lines Changed: report 

The report option tells you the number of lines modified by a line-oriented 
command. For example, 

:set report** 1 

reports the number of lines modified, if more than one line is changed. The 
default setting is 

report=5 

which reports the number of lines changed when more than five lines are 
modified. 



5.5.7 Changing the Terminal Type:term 

If you are logged in on a terminal that is a different type than the one you 
normally use, you can check the terminal type setting by typing: 

:set term 

Press RETURN. See section 5.5.1, "Setting the Terminal Type" for more 
information about TERM variables. 



5.5.8 Shortening Error Messages: terse 

After you become experienced with vi, you may want to shorten your error 
messages. To change from the default (noterse), type 

:set terse 

As an example of the effect of terse, when terse is set the message 
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No write since last change, quit! overrides 
becomes 

No write 

5.5.9 Turning Off Warnings: warn 

After you become experienced with vi, you may want to turn off the error 
message that appears if you have not written out your file before a shell escape 
(:!) command. To turn these messages off, type 

:set nowarn 



5.5.10 Permitting Special Characters in Searches: nomagic 

The nomagic option allows the inclusion of the special characters (. \ $ [ ]) in 
search patterns without a preceding backslash. This option does not affect caret 
(*) or star (*); they must be preceded by a backslash in searches regardless of 
magic. To set nomagic, type 

:set nomagic 



5.5.11 Limiting Searches: wr apse an 

By default, searches in vi "wrap" around the file until they return to the place 
they started. To save time you may want to disable this feature. Use the 
following command: 

:set nowrapscan 

When this option is set, forward searches go only to the end of the file, and 
backward searchesstop at the beginning. 



5.5.12 Turning on Messages: mesg 

If someone sends you a message with the write command while you are in vi the 
text of the message will appear on your screen. To remove the message from 
your display you must press CNTRL-L. When you invoke vi, write permission 
to your screen is automatically turned off, preventing write messages from 
appearing. If you wish to receive write messages while in vi, reset this option as 
follows: 

:set mesg 
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5.5.13 Customizing Your Environment: The .ex re File 

Each time vi is invoked, it reads commands from the file named .exrc in your 
home directory. This file sets your preferred options so that they do not need to 
be set each time you invoke vi. A sample .exrc file follows: 

set number 
set ignore case 
set nowarn 
set report=l 

Each time you invoke vi with the above options, your file is displayed with line 
numbers, case is ignored in searches, warnings before shell escape commands 
are turned off, and any command that modifies more than one line will display a 
message indicating how many lines were changed. 
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5.6 Summary of Commands 



The following tables contain all the basic the commands discussed in this 
chapter. 



Entering Vi 



Typing this: 


Does this: 


vifile 


Starts at line 1 


vi+n file 


Starts at linen 


vi + file 


Starts last line 


vi+ /patter nfile 


Starts at pattern 


v\-t file 


Recovers file after a 
system crash 
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Cursor Movement 



Pressing this key: 


Does this: 


h 
1 
SPACEBAR 


Moves 1 space left 
Moves 1 space right 
Moves 1 space right 


w 

b 


Moves 1 word right 
Moves 1 word left 


k 

J 
RETURN 


Moves 1 line up 
Moves 1 line down 
Moves 1 line down 


)■ 
( 


Moves to end of sentence 
Moves to beginning of sentence 


} 
{ 


Moves to beginning of par agraph 
Moves to end of paragraph 


CNTRL-W 


Moves to first character of 




insertion 


CNTRL-U 


Scrolls up 1/2 screen 


CNTRL-D 


Scrolls down 1/2 screen 


CNTRL-F 


Scrolls down one screen 


CNTRL-B 


Scrolls up one screen 
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Inserting Text 



Pressing 


Starts insertion: 


i 


Before the cursor 


I 


Before first character on the line 


a 


After the cursor 


A 


After last character on the line 


o 


On next line down 





On the line above 


r 


On current character, replaces 
one character only 


R 


On current character, replaces 
until ESC 



Delete Commands 



Comm 


and 


Function 


dw 




Deletes a word 


do 




Deletes to beginning of line 


d$ 




Deletes to end of line 


3dw 




Deletes 3 words 


dd 




Deletes the current line 


5dd 




Deletes 5 lines 
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Change Commands 



Command 


Function 


cw 


Changes 1 word 


3cw 


Changes 3 words 


cc 


Changes current line 


5cc 


ChangesS lines 



Search Commands 



Command 


Function 


Example 


/and 


Finds the next 
occurrence of and 


and, stand, grand 


?and 


Finds the previous 
occurrence of and 


and, stand, grand 


/'The 


Finds next line that 
starts with The 


The, Then, There 


/(bBjox/ 


Finds the next 
occurrence of box 
or Box 




n 


Repeats the most 
recent search, in 
the same direction 
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Command 

:s/pear/peach/g 



Result 

All pears become 
peach on the 
current line 



Example 



:l,$s/file/directory Replaces file with filename becomes 

directory from line directory name 
1 to the end. 

:g/one/s//l/g Replaces every one becomes 1, 

occurrence of one oneself becomes 

with 1. lself, someone 
becomes somel 



Pattern Matching: Special Characters 



This character: 


Matches: 


- 


Beginning of a line 


$ 


End of a line 


• 


Any single character 


(1 


A range of characters 
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Leaving Vi 



Command 


Result 


:w 


Writes out the file 


:x 


Writes out the file, quits vi 


:qi 


Quits vi without saving 
changes 


:!command 


Executes command 


:!sh 


Forks a new shell 


!!command 


Executes command and 




places output on current 
line 


:e file 


Edits file (save current file 
with :w first) 
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Options 



This option: 


Does this: 


all 


Lists all options 


term 


Sets terminal type 


ignorecase 


Ignores case in searches 


list 


Displays tab and end-of-line characters 


number 


Displays line numbers 


report 


Prints number of lines changed by a line-oriented command 


terse 


Shortens error messages 


warn 


Turns off "no write" warning before escape 


nomagic 


Allows inclusion of special characters in search patterns 
without a preceding backslash 


nowrapscan 


Prevents searches from wrapping around the end or 
beginning of a file. 


mesg 


Permits display of messages sent to your terminal with 
the write command 
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6.1 Introduction 



The XENIX mail system is a versatile communication facility that allows 
XENIX users to compose, send, receive, forward, and reply to mail. Users can 
also create distribution groups and send copies of messages to multiple users. 
These functions are integrated into XENIX so that all users can quickly and 
easily communicate with each other. 

This chapter is organized to satisfy the needs of both the beginning and 
advanced user. The first sections discuss basic concepts, tasks, and commands. 
Later sections discuss advanced topics and provide quick reference to the mail 
program's many functions. The major sections in this chapter are: 

Demonstration Shows new users how to get started. 

Basic Concepts Discusses the fundamental ideas and terminology 

used in mail. 

Using Mail Shows how to perform common mailing procedures 

such as composing, sending, forwarding, and 
replying to mail. 

Commands Discusses each mail command. 

Leaving Compose Mode Temporarily 

Discusses and gives examples of each command 
available when composing a message. These 
commands are called compose escapes. 

Setting Up Your Environment 

Discusses the user's mail startup file and options 
that may be set to customize functions. 

Using Advanced Features 

Discusses advanced features such as using mail as a 
reminder service and handling a large volume of 
mail. 

Quick Reference Summarizes all commands, compose escapes, and 

options. 
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6.2 Demonstration 



The mail command lets you perform two distinct functions: sending mail and 
disposing of mail. In this demonstration, we will show you how to send mail to 
yourself, read a message, delete, it, and exit the mail program. 



6.2.1 Composing and Sending a Message 

To begin, type 

mail self 

where "self" is your user name. Next, type the following lines, each terminated 
with a RETURN: 

This is a message sent to myself. 

I compose a message by entering lines of text. 

The message is ended by typing CNTRL-D on a newline. 

As you enter the message you can use compose eeeapee to perform special 
functions. To get a list of the available compose escapes, type 

"? 

on a new line. To specify a subject, use the ~s escape. For example, type: 

"s Sample subject 

To specify a list of people to receive carbon copies use the "c escape. For 
example, type 

*c abel 

To view the message as it will appear when you send it, type: 

"P 
This will print the following: 

Message contains: 
To: self 

Subject: Sample subject 
Cc: abel 

This is a message sent to myself. 

I compose a message by entering lines of text. 

The message is ended by typing CNTRL-D on a newline. 
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Finally, to end the message and send it to those you have mentioned in the To: 
and the Cc: fields, press CNTRL-D by itself on a line. This will exit the mail 
program and return you to the XENIX shell. Once you have sent mail, there is 
no way to undo the act, so be careful. 



6.2.2 Reading Mail 

Within a short time, you should receive the message: 

You have mail. 

(You must press RETURN before this message will appear on your screen.) This 
message informs you that the message you have just sent has arrived in your 
system mailbox. To read this message and any others that may have been sent 
to you, type 

mail 

Mail then displays a sign-on message and a list of message headers that look 
something like this: 

Mail version 3.0 August 30, 1982. Type ? for help. 
1 message: 
1 self Fri Aug 31 12:26 7/188 "Sample subject" 



When there is more than one message in your mailbox, the most reeentmessage 
is displayed at the top of the list. Messages are numbered in ascending order 
from least to most recent, so the message at the top of the list (the most recent 
message) has the highest number. The message header includes who sent the 
message, when it was sent, the number of lines and characters, and the subject 
of the message. The underscore prompt prompts you to enter a mail 
command. Now type 



to get help on all the available mail commands. Next, type 

P 
to see the message that you sent to yourself. Mail prints the following: 
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From self Fri Aug 20 12:26:52 1982 

To: self 

Subject: Sample subject 



This is a message sent to myself. 

I compose a message by entering lines of text. 

The message is ended by typing CNTRL-D on a newline. 



Note that the message you sent to yourself now contains information about the 
sender of the message-- a line telling who sent the message and when it was sent. 
The next line tells who the message was sent to. A subject and carbon copy (Cc:) 
field can be specified by the sender. If they are present, they too are displayed 
when you read the message. 



6.2.3 Leaving Mail 

Since this message has no real use, you can delete it by typing: 

d 
To get out of mail, type: 

q 

Mail then displays the message 

messages held in /usr/spool/mail/sclf 

and returns you to the XENIX shell. 

This ends the demonstration. For more detailed information, see the 
discussions in following sections. 

6.3 Basic Concepts 

It is much easier to use mail if you understand the basic concepts that underlie 
it. The concepts discussed in this section are: 

— Mailboxes 
Messages 

— Modes 

— Command syntax 
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6.3.1 Mailboxes 

It is useful to think of the mail system as modeled after a typical postal system. 
What is normally called a post office is called the eyetem mailbox in this chapter. 
The system mailbox contains a file for each user in the directory 
fusr/ spool/ mail. Your own personal or titer mailbox is the file named mbox in 
your home directory. Mail sent to you is put in your system mailbox; you may 
choose to save mail in your user mailbox after you have read it. Note that the 
user mailbox differs from a re ai mailbox in several respects: 



1. You decide whether mail is to be placed in the user mailbox; it is not 
automatically placed there. 

2. The user mailbox is not the place where mail is initially routed — that 
place is the system mailbox in the directory /tier/ spool/ mail. 

3. Mail is not picked up /rom your user mailbox. 



6.3.2 Messages 

In mail, the message is the basic unit of exchange between users. Messages 
consist of two parts: a heading and a body. The heading contains the following 
fields: 

To: This field is mandatory and contains one or more valid user names 

corresponding to real users to whom you may send mail. 

Subject: This optional field contains text describing the message. 

Cc: The carbon copy field contains one or more valid names of those 

who are to receive copies of a message. Message recipients see these 
names in the received message. This field can be empty. 

Bcc: The blind carbon copy field contains the one or more valid names of 

people who are to receive copies of a message. Recipients do not see 
these names in the received messages. This field can be empty. 

Return- receipt- to: 

The return receipt to: field contains the valid name or names of 
those who are to receive an automatic acknowlegement of the 
message. This field can be empty. 

The body of a message is text exclusive of the heading. The body can be empty. 
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6.3.3 Modes 



Often, the biggest hurdle to using mail is understanding what modes of 
operation are available. This section discusses each mode. 

When you invoke mail you are using the shell. If you want to mail a letter 
without entering mail command mode, you can do so by typing 

mail John <letter 

Here, the file le tte r is sent to the user John. 



Note 



Be very careful when mailing a file with the input redirection symbol 
(<). If you accidentally type the output redirection symbol (>), you 
will overwrite the file, destroying its contents. 



You can enter a message from your shell by typing: 

mail John 
Next, enter the text of your message as follows: 

This is the text of the message. 

Press RETURN to start a new line, then CNTRL-D to send the message. 
Messages such as the one above are created in mail's compote mode. When 
entering text in compose mode, there are several special keys associated with 
line editing functions: these are the same special characters that are available 
to you when executing normal XENIX commands. For example, you can kill the 
line you are editing by typing the kill character, normally a CNTRL-U. To 
backspace, press either CNTRL-H or the BACKSPACE key. From compose 
mode, you can issue commands called compose escapes. These are also called 
tilde tec apt s because the command letters are preceded by a tilde (~). When 
you execute these commands you are temporarily leaving or escaping from 
compose mode; hence the name. Note that once you've pressed RETURN to end 
a line, you cannot change that line from within compose mode; to change it, you 
must enter edit mode. 

The most common way of using mail is to just type 

mail 

This automatically places you in mail command mode. In this mode, you are 
prompted by an underscore for commands that permit you to manipulate your 
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mail. 

You can enter edit mode from either compose mode or command mode. In edit 
mode, you edit the body of a message using the full capabilities of an editor. To 
enter edit mode from command mode, use either the e or edit command to 
enter ed, or the v or visual command to enter vi. ( Vt may not be available on 
your system.) To enter edit mode from compose mode, use the compose escapes 
~e and ~v, respectively. 



6.3.4 Message-Lists 

Many mail commands take a list of messages as an argument. Ameetage-littis 
a list of message numbers, ranges, and names, separated by spaces or tabs. 
Message numbers may be either decimal numbers, which directly specify 
messages, or one of the special characters A , . , or $ , which specify the first, 
current, or last undeleted message, respectively. Here, relevant means not 
deleted. 

A range of messages is two message numbers separated by a dash. To print the 
first four messages on the screen, type 

p 1-4 

and to print all the messages from the current message to the last message, type 
■p.-t 

A name is a user name. Messages can be printed by specifying the name of the 
sender. For example, to print each message sent to you by John, type 

p John 

As a shorthand notation, you can specify star (*) to get all undelete (/messages. 
Thus, 

P* 
prints all messages except those that have been deleted, 

d * 

deletes all messages, and 

u * 

undeletes all deleted messages. (All three of these commands are described 
later in detail in Section 6.5 "Commands.") 
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6.3.5 Headers 

When you enter mail, a list of message headers is displayed. A header is a 
single line of text containing descriptive information about a message. (Note 
that we use the word heading to describe the first part of a message, and header 
to describe mail's one-line description of a message.) The information includes: 

— The number of the message . - 

— The sender 

— The date sent 

— The number of characters and lines 

— The subject (if the message contains a Subject: field) 

Message headers are displayed in windows with the headers command. A 
header window contains no more than 18 headers. If there are fewer than 18 
messages in the mailbox, all are displayed in one header window. If there are 
more than 18 messages, then the list is divided into an appropriate number of 
windows. You can move forward and backward one window at a time with the 

headers + 
and 

headers - 
commands. 

6.3.6 Command Syntax 

Each mail command has its own syntax. Some take no arguments, some take 
only one, and others take several arguments. The more flexible commands, 
such as print, accept combinations of message-lists and user names. For these 
commands, mail first gathers all message numbers and ranges, then finds all 
messages from any specified user names. The full message-list is the 
intersection of these two sets of messages. Thus, the message-list "4-15 miller" 
matches all messages between 4 and 15 that are from miller. 

Each mail command is typed on a line by itself, and any arguments follow the 
command word. The command need not be typed in its entirety — the first 
command that matches the typed prefix is used. For example, you can type "p" 
instead of "print" for the print command and "h" instead of "headers" for the 
headers command. 
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After the command itself is typed, one or more spaces should be entered to 
separate the command from its arguments. If a mail command does not take 
arguments, any arguments you give are ignored and no error occurs. For 
commands that take message-lists as arguments, if no message-list is given, the 
last message printed is used. If it does not satisfy the requirements of the 
command, the search proceeds forward. If there are no messages forward of the 
current message, the search proceeds backwards, and if there are no good 
messages at all, mail types: 

No applicable messages 



6.4 Using Mail 

This section describes how to perform some basic tasks when using mail. More 
detailed discussions of each of these commands are presented in later sections. 



6.4.1 Entering and Exiting Mail 

To begin a session with mail, type: 

mail 

The headers for each received message are then displayed one screenful at a 
time. To display the next screenful of headers (if any), type 

h+. 

To end the mail session, use the quit (q) command. All messages remain in the 
system mailbox unless they have been deleted with the delete (d) command, 
saved with the save or write command, or held in your user mailbox with the 
mbox command. Deleted messages are discarded. The -f command line 
option causes mail to read in the contents of mbox. Optionally, a filename may 
be given as an argument to -f, so that the specified file is read, instead. When 
you quit, mail writes all messages back to this file. 

If you send mail over a noisy phone line, you will notice that many of the bad 
characters turn out to be the RU BOUT or DEL character, which causes mail to 
abort messages. To deal with this annoyance, you can invoke mail with the -i 
option which causes these bad characters to be ignored. 

6.4.2 Sending Mail 

To send a message, invoke mail with the names of the people and groups you 
want to receive the message. Next, type in your message. When you are 
finished, press CNTRL-D at the beginning of a line. The message is 
automatically sent to the specified people. While entering the text of your 
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message, you can escape to an editor or perform other useful functions with 
compose escapes. Section 6.4.5, "Composing Mail", describes some features of 
mail available to help you when composing messages. 

If you have a file that contains a written message, you can send it to sam, bob, 
and John by typing: 

mail sam bob John <letter 

where letter is the name of the file you are sending. 



Note 



Be very careful when mailing a file with the input redirection symbol 
(<).■ If you accidentally type the output redirection symbol (>), you 
will overwrite the file, destroying its contents. 



If mail cannot be delivered to a specified address, you will either be notified 
immediately, in which case a copy of the undeliverable message is appended to 
the file dead.letter, or you will be notified via return mail, in which case a copy is 
included in the return mail message. 



6.4.3 Reading Mail 

To read messages sent to you, type 

mail 

Mail then checks your mail out of the system mailbox and prints out a one-line 
header of each message, one screenful at a time (to view the next screenful, type 
"h+". The most recent message is initially the first message (numbered 
highest, because messages are numbered chronologically) and may be printed 
using the print command. You can move forward one message by pressing 
RETURN or typing '+'. To move forward n messages use "+n". You can move 
backwards one message with the "-" command or move backwards n messages 
and print with "-n". You can also move to any arbitrary message and print it 
by typing its number. 

If new messages arrive while you are in mail, the following message appears: 

New mail has arrived— type 'restart' to read. 

Type 



6-10 



Mail 



restart 
and the headers of the new messages are displayed. 

6.4.4 Disposing of Mail 

After examining a message you can delete it with the delete (d) command, 
reply to it with the reply (r) command, forward it with the forward (f) 
command, or skip to the next message by pressing RETURN. Deletion causes 
the mail program to forget about the message. This is not irreversible; the 
message can be undeleted with the undelete (u) command by typing 

u number 

6.4.5 Composing Mail 

To compose mail, you must enter compose mode. Do this from XENIX 
command level by typing 

mail John 

where John is the name of a user to whom you want to send mail. From mail 
command mode, you can enter compose mode with the mail, reply, or Reply 
commands. Once in compose mode, the text that you type is appended one line 
at a time to the body of the message you are sending. Normal line editing 
functions are available when entering text, including CNTRL-U to kill a line and 
BACKSPACE to back up one character. Note that entering two interrupts in a 
row (i.e., pressing INTERRUPT twice), aborts your composition. 

While you are composing a message, mail treats lines beginning with the tilde 
(~) in a special way. This character introduces commands called compose 
escapes. For example, typing 



by itself on a line places a copy of the most recently printed message inside the 
message you are composing. The copy is shifted right one tabstop. Other 
escapes set up heading fields, add and delete recipients to the message, allow 
you to escape to an editor, let you revise the message body, or run XENIX 
commands. To get a list of the available compose escapes when in compose 
mode, type: 



See also Section 6.6, "Compose Escapes", later in this chapter. 
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6.4.6 Forwarding Mail 

To forward a message, use the forward (f) command. For example, type 

f John 

to place a copy of the current message inside a new message. The copy is shifted 
right one tabstop, and the new message is forwarded to John. John will receive 
a message heading indicating that you have forwarded the message. The 
Forward (F) command works just like its lowercase counterpart, except that 
the forwarded message is not shifted right one tabstop. 

6.4.7 Replying to Mail 

You can use the reply command to set up a response to a message, 
automatically addressing a reply to the person who sent the original message. 
You then type in text and send the message by pressing CTNRL-D on a line by 
itself. The Reply command works just like its lowercase counterpart, except 
that the message is sent to others named in the original message's "To:" and 
"Cc:" fields. 

6.4.8 Specifying Messages 

Commands such as print and delete can be given a message-list argument to 
apply to several messages at once. Thus "delete 2 3" deletes messages 2 and 3, 
while "delete 1-5" deletes messages 1 through 5. A star (*) addresses all 
messages, and a dollar sign ($) addresses the last (highest numbered) message. 
The top (t) command prints the first five lines of a message; hence, you can type 

top * 

to print the first five lines of every message. Message-lists can contain 
combinations of lists, ranges, and names. For example, the following command 
prints out all messages from torn or bob and numbered 2,4, 10, 11, or 12: 

p torn bob 2 4 10-12 

6.4.9 Creating Mailing Lists 

You can create personal mailing lists so that, for example, you can send mail to 
eohorte and have it go to a group of people. Such lists are defined by placing an 
aliae line like 

alias cohorts bill bob barry 

in the file .mailre in your home directory. The current list of such aliases can be 
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displayed with the alias (a) mail command. Personal aliases are expanded in 
mail sent to others so that they will be able to Reply to each individual 
recipient. For example, the 7V: field in a message sent to cohorte will read 

To: bill bob barry 

and not 

To: cohorts 

Normally, system-wide aliases are available to all users. These are installed by 
whoever is in charge of your system. For more information, see section 6.8, 
"Using Advanced Features", later in this chapter. 

6.4.10 Sending Network Mail 

Mail can be sent between XENIX machines connected with Micnet by specifying 
a machine name and the user name on that machine, separated by a colon: 

machine:user 

If appropriate gateways are known to your system, you can send mail to sites 
within the UUCP network using the syntax: 

machineluser 

(Be sure to escape the ! by preceding it with a backslash (\) when giving it on a 
eeh command line.) Mail may also interpret other characters in the mail path 
when dealing with other networks. In most cases, aliases should be set up so 
that specifying machine names is unnecessary. For more information about 
sending network mail, see the XENIX Operations Guide. 



6.4.11 Setting Options 

Mail has several options that you can set from mail command mode or in the 
file .mailrc in your home directory. For example, "set askcc" enables the askcc 
switch and causes prompting for additions to the Ce: field when you finish 
composing a message. These and other options are discussed in Section 6.7 
"SettingUpYour Environment: The .mailrc File". 



6.5 Commands 

This section describes each of the commands available to you in mail command 
mode. The examples in this section assume you have invoked mail and that 
you have several messages you want to dispose of. Note that in general, mail 
commands can be invoked with either the name of the command or a one- or 
two-character mnemonic abbreviation. In the text of the command 
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descriptions below, this mnemonic abbreviation is enclosed in parentheses 
after the name of the command. All commands are printed in boldface, except 
in the examples. 



6.5.1 Getting Help: help and ? 

The help (?) command prints out a brief summary of all mail commands, so if 
you ever get stuck when you are in m ail command mode, type: 



help 



6.5.2 Reading Mail: p, +, -, and re$tart 

To look at a specific message, use the print (p) command. For example, 
pretend you have a header-list that looks like this: 

3 John Wed Sep 21 09:21 26/782 "Notice" 
2 sam Tue Sep 20 22:55 6/83 "Meeting" 
1 torn Mon Sep 19 01:23 6/84 "Invite" 

Reading from the left, each header contains the message number, who sent it, 
the day, date, and time it was sent, the number of lines and characters in the 
message, and its subject. 

To examine the second message, type: 

P 2 

This might cause mail to respond with: 

Message 2: 

From sam Tue Sep 20 22:55 1983 

Subject: Meeting 

Meeting everyone, please don't forget! 
To look at message 3, type 



or to look at message 1, type 
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The commands + and - execute relative to the last message referred to, which 
in our example was 2. For large numbers of messages, you can skip forward and 
backward by the number of messages specified as an argument to + and -. For 
example, typing 

+3 

skips forward three messages. If you type 

p * 

then all messages are displayed, since the star (*) matches all messages. 

Pressing RETURN prints out the next message in the header-list. You can can 
always go to a message and print it by giving its message number or one of the 
special characters, caret (*), dot (.), or dollar sign ($). In the example where 
message 2 is the current message 



prints the current message, 

prints message 1, and 

$ 

prints message 3. 

When new mail arrives while you are in mail, the message "New mail has 
arrived-type 'restart' to read". If you wish to read the new messages, type 

restart 

The headers of the new messages appear. 

6.5.3 Finding Out the Number of the Current Message: = 

The number (=) command prints out the message number of the current 
message. It takes no arguments. 

6.5.4 Displaying the First Five Lines : t 

The top (t) command takes a message-list and prints the first five lines of each 
addressed message. For example 
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top 2-12 



prints out the first five lines of each of the messages 2 through 12. Note that the 
number of lines printed out by top can be set with the toplinet option. 



6.5.5 Displaying Headers: h 

The headers (h) command displays header windows or lists of headers. A 
header window contains no more than 18 headers. With no argument, the 
headers command displays a header window in which the current message 
header is displayed at the center of the window. 

To examine the next set of 18 headers, type: 

h + 
To examine the previous set, type: 

h- 

Both plus and minus take an optional numeric argument that indicates the 
number of header windows to move forward or backward before printing. If a 
message-list is given, then the headers command prints out the header line for 
each message in the list, disregarding all windowing. For example 

h joe 

displays all the message headers from joe. The following are some 
characteristics of the header-list: 

— Deleted messages do not appear in the listing. 

— Messages saved with the save command are flagged with a star (*). 

— Messages to be saved in your user mailbox are flagged with an "M". 

— If the autombox option is set, messages held with the hold command 
are flagged with an "H". 

6.5.6 Deleting Messages: d and dp 

Unlessyou indicate otherwise, each message you receive is automatically saved 
in the system mailbox when you quit mail. Often, however, you don't want to 
save messages you have received. To delete messages, use the delete (d) 
command. For example, 

delete 1 
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prevents mail from retaining message 1 in the system mailbox. The message 
will disappear altogether, along with its number. 

The dp command deletes the current message and prints the next message. Itis 
useful for quickly reading and disposing of mail. Using dp is the same as using 
the d command with the aut oprint option set. See also the undelete command, 
below. 



6.5.7 Undeleting Messages: u 

The undelete (u) command causes a message that has been previously deleted 
with d or dp to reappear as if it had never been deleted. For example, to 
undelete message 3, type 

u3 

You cannot undelete messages from previous mail sessions; they are gone for 
good. 



6.5.8 Leaving mail : q and x 

When you have read all your messages, you can leave mail with the quit (q) 
command. All messages are held in your system mailbox, except the following: 

— Deleted messages, which are discarded irretrievably. 

— Messages marked with the mbox command, which are saved in mbox 
in your home directory (i.e M your user mailbox). 

— Messages saved with the save and write commands are deleted from 
the system mailbox. Forwarded messages are not deleted. 

Note that if the autombox option is set, messages that you have read are 
automatically saved in your user mailbox. If you wish to leave mail quickly 
without altering either your system or user mailbox, you can use the exit (x) 
command. This returns you to the shell without changing anything: no 
messages are deleted or saved. Files that you invoke with the mail -f switch 
are unaffected as well. 



6.5.9 Saving Your Mail: s 

The save (s) command lets you save messages to files other than mbox. By 
using save, you can organize your mail by putting messages in appropriate 
files. The save command writes out each message to the file given as the last 
argument on the command line. For example, the following command appends 
messages 1-5 to the file let tere: 
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s 1-5 letters 



The file letters is created if it does not already exist. Saved messages are not 
automatically retained in the system mailbox when you quit, nor are they 
selected by the print command described above, unless explicitly requested. 
Each saved message is marked with a star (*). 

Save writes out the entire message, including the To:, Subject:, and Cc: fields. 
In comparison, the write command, discussed below, writes outonly the bodies 
of the specified messages. 



6.5.10 Saving Your Mail: w 

The write (w) command writes out the body of each message to the file given as 
the last argument on the command line. Each written message is marked with a 
star(*). The syntax is similar to that of the save command. For example, 

w 3-17 john elliot book 

writes out the bodies of all messages from john and elliot in the number range 
3- 17. They are concatenated to the end of the file named book. 



6.5.11 Saving Your Mail: mb 

The mbox (mb) command marks each message specified in a message-list, so 
that all are saved in the user mailbox when a quit command is executed. 
Message headers are marked with an "M" to show that they are to be saved in 
mbox. 



6.5.12 Saving Your Mail: ho 

The hold (ho) command takes a message-list and marks each message so that it 
is saved in your system mailbox instead of deleted or saved in mbox when you 
quit. Saving of files in the system mailbox happens by default, so use hold only 
when you have also set the automb ox option. 



6.5.13 Printing Your Mail on the Lineprinter: 1 

The lpr (1) command paginates and prints out messages to the lineprinter. It 
takes a message-list as its argument, then paginates and prints out each 
message. For example 

1 doug 

prints out each message from the user doug on the lineprinter. 
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6.5.14 Sending Mail: m 

To send mail to a user, use the mail (m) command. This sends mail in the 
manner described for the reply command, except that you supply a list of 
recipients either as an argument of by entering them in the To: field. All 
compose escapes work in mail. Note that the mail command is in most ways 
identical to typing mail tteert at the XENIX command level. 



6.5.15 Replying to Mail: r and R 

Often, you want to deal with a message by responding to its author right away. 
The reply (r) command is useful for this purpose: it takes a message-list and 
sends mail to the author of each message. The original message's subject field is 
copied as the reply 's subject. Each message is composed in compose mode; thus 
all compose escapes work in reply, and messages are terminated by pressing 
CNTRL-D. 

The Reply (R) command works just like its lowercase counterpart, except that 
copies of the reply are also sent to everyone shown in the original message's 
"To:" and "Cc:" fields. 



6.5.16 Forwarding Mail: f and F 

To forward a copy of a message, use the forward (f) command. This causes a 
copy of the current message to be sent to the specified users. The message is 
marked as saved, and then deleted from the system mailbox when you exit mail. 
For example, to forward the current message to someone whose login name is 
John, type 

f john 

John will receive the forwarded message, along with a heading showing that 
you are the one who forwarded it. Inside the new message, the forwarded 
message is indented one tab stop. An optional message number can also be 
given. For example, 

f 2 John bill 

forwards message 2 to John and bill. 

The Forward (F) command is identical to the lowercase forward command, 
except that the forwarded message is not indented. 



6.5.17 Creating Mailing Lists: a 

The alias (a) command links a group of names with the single name given by 
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the first argument, thus creating a mailing list. For example, you could type 

alias beatles John paul george ringo 

so that whenever you used the name beatlet in a destination address (as in "mail 
beatles"), it would be expanded so that you are really referring to the four 
names aliased to beatles. With no arguments, alias prints out all currently- 
defined aliases. With one argument, it prints out the users defined by the given 
alias. 

You will probably want to define aliases in the startup file, .mailrc, so that you 
don't have to redefine them each time you invoke mail. See section 6.7, 
"Setting Up Your Environment: The .mailrc File" , for more information. 



6.5.18 Setting and Unsetting Options: se and uns 

Mail switch and string options can be set with the mail commands set and 
unset. A switch option is either on or off (set or unset). String options are 
strings of characters that are assigned values with the syntax option**etring. 
Multiple options may be specified on a line. It is most useful to place set and 
unset commands in the file .mailrc in your home directory, where they become 
your own personal default options when you invoke mail. For example, you 
might have a set command that looked like this: 

set dot metoo toplines=10 SHELL=»/usr/bin/sh 

The options dot and metoo are switch options; toplinee and SHELL are string 
options. 

The command 

set ? 

prints out a list of the available options. See the section "Setting Up Your 
Environment", for descriptions of these options. 



6.5.10 Editing a message: e and v 

To edit individual messages using the text editor , use the edit (e) command. It 
takes a message-list and processes each message in turn by writing it to a 
temporary file. The editor, erf, is then automatically invoked so that you can 
edit the temporary file. When you finish editing the message, write the message 
out, then quit the editor. Mail reads the message back into the message buffer 
and removes the temporary file. 

It is often useful to be able to invoke either a line or visual editor, depending on 
the type of terminal you are using. To invoke vi } you can use the visual (v) 
command. (Note that vi is not available on all XENIX systems.) The operation 
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of the visual command is otherwise identical to that of the edit command. 

6.5.20 Executing Shell Commands: sh and ! 

To execute a shell command without leaving mail, precede the command with 
an exclamation point. For example 

Idate 
prints out the current date without leaving mail. To enter a new shell, type: 

sh 
To exit from this new shell and return to mail command mode, press CNTRL-D. 

6.5.21 Finding Out the Number of Characters in a Message: si 

The size (si) command prints out the number of characters in each message in a 
message-list. For example, the command 

si 1-4 

might print out: 



234 
1000 
23 
456 



6.5.22 Changing the Working Directory: cd 

The cd command changes the working directory to the name of the directory 
you give it as an argument. If no argument is given, the directory is changed to 
your home directory. This command works just like the normal XENIX cd 
command. (Note that exiting mail returns you to the directory from which 
you entered mail; thus the mail cd command works only within mail.) You 
may want to place a cd command in your .mailre file so that you always begin 
executing mail from within the same directory. 



6.5.23 Reading Commands From a File: so 

The source (so) command reads in mail commands from the file Normally, 
these commands are alias, set, and unset commands. 
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6.6 Leaving Compose Mode Temporarily 

While composing a message to be sent to others, it is often useful to print a 
message, invoke the text editor on a partial message, execute a shell command, 
or perform some other function. Mail provides these capabilities through 
eompoee escapee (sometimes called tilde etcapet) which consist of a tilde (") at 
the beginning of a line, followed by a single character that specifies the function 
to be performed. These escapes are available only when you are composing a 
new message. They have no meaning when you are in mail command mode. 
The available compose escapes are described below. 



6.6.1 Getting Help: "? 

The help escape is the first compose escape you should know because it tells you 
about all the others. For example, if you type 



a brief summary of the available compose escapes is printed on your screen. 
Note that ~h prompts for heading fields and and does not give help. 



6.6.2 Printing the Message: "p 

To print the current text of a message you are composing, type: 

"P 
This prints a line of dashes and the heading and body of the message so far. 

6.6.3 Editing the Message: "e and "v 

If you are dissatisfied with a message as it stands, you can edit the message by 
invoking the editor, ed, with the editor escape, "e. This causes the message to 
be copied into a temporary file so that you can edit it. Similarly, the "v escape 
causes the message to be copied into a temporary file so that you can edit it with 
the vi editor. (Note that vi is not available on all XENIX systems.) After 
modifying the message to your satisfaction, write it out and quit the editor. 
Mail responds by typing 

(continue) 

after which you may continue composing your message. 
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6.6.4 Editing Headers: ~t, "c, ~b, ~s, "R and ~h 

To add additional names to the list of message recipients, type the escape: 

~t namel name2 ... 

You can name as many additional recipients as you wish. Note that users 
originally on the recipient list will still receive the message: you cannot remove 
anyone from the recipient list with ~t. To remove a recipient, use the "h 
command, which is discussed later in this section. 

You can replace or add a subject field by using the ~s escape: 

~s line -of -text 

This replaces any previous subject with line-of-text. The subject, if given, 
appears near the top of the message, prefixed with the heading Subject:. You 
can see what the message looks like by using ~p, which prints out all heading 
fields along with the body of the text. 

You may occasionally prefer to list certain people as recipients of carbon copies 
of a message rather than direct recipients. The escape 

~c namel name2 ... 
adds the named people to the Cc/list. The escape 

~cc namel name2 ... 
performs an identical function. Similarly, the escape 

~b namel name2 ... 

adds the named people to the Bee: (Blind carbon copy) list. The people on this 
list receive a copy of the message, but are not mentioned anywhere in the 
message you send. Remember that you can always execute a *p escape to see 
what the message looks like. 

The escape 

"R 

adds or changes the person or persons named in the return-receipt to: field. 

The recipients of the message are given in the To: field; the subject is given in 
the Subject: field, carbon copy recipients are given in the Ce: field and the 
return receipt recipient in the Return-receipt-to: field. If you wish to edit these 
in ways impossible with the ~t, ~s, ~c, and ~R escapes, you can use 
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where h stands for "heading". The escape "h prints To: followed by the current 
list of recipients and leaves the cursor at the end of the line. If you type in 
ordinary characters, they are appended to the end of the current list of 
recipients. You can also use the normal XENIX command line editing characters 
to edit these Melds, so you can erase existing heading text by backspacing over 
it. 

When you press RETURN, mail advances to the Subject: field, where the same 
rules apply. Another RETURN brings you to the Cc: field, another bringsyou to 
the Bcc: field, and yet another to the Return-receipt-to: field. Each of these 
fields can be edited in the same way. Finally, another RETURN leaves you 
appending text to the end of your message body. As always, you can use "p to 
print the current text of the heading fields along with the body of the message. 



6.6.5 Adding a File to the Message: ~r and "d 

It is often useful to be able to include the contents of some file in your message. 
The escape 

"r filename 

is provided for this purpose, and causes the named file to be appended to your 
current message. Mail complains if the file doesn't exist or can't be read. If the 
read is successful, mail prints the number of lines and characters appended to 
your message. 

As a special case of "r, the escape 

-d 

reads in the file dead.letter in your home directory. This is often useful because 
mail copies the text of your message buffer to dead.letter whenever you abort 
the creation of a message by either typing two consecutive interrupts or 
entering a ~q escape. 



6.6.6 Enclosing Another Message: ~m and ~M 

If you are sending mail from within mail's command mode, you can insert a 
message sent to you into the message you are currently composing. For 
example, you might type: 

"m 4 

This reads message 4 into the message you are composing, shifted right one tab 
stop. The escape 
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~M4 

performs the same function, but with no right shift. You can name any 
nondeleted message or list of messages. 



6.6.7 Saving the Message in a File: ~w 

To save the current text of a message body in a file, use: 

"w filename 

Mail writes out the message body to the specified file, then prints the number 
of lines and characters written to the file. The ~w escape does not write the 
message heading to the file. 

6.6.8 Leaving Mail Temporarily: "! and "J 

To temporarily escape to the shell, use the escape 

''command 

This executes command and returns you to mail compose mode without 
altering your message. If you wish to filter the body of your message through a 
shell command, use 

~\command 

This pipes your message through the command and uses the output as the new 
text of your message. This escape is particularly useful with the fmt command 
which performs simple formatting operations on the text of your message. If 
the command produces no output, mail assumes that something is wrong, 
retains the old version of your message, and prints: 

(continue) 

6.6.0 Escaping to Mail Command Mode: ~: 

To temporarily escape to mail command mode, use either of the escapes 

~:m ail- command 

~ _mail- command 

You can then execute any mail command that you want. Note that this escape 
does not work if you enter compose mode from the XENIX shell. You will receive 
the message: 
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May not execute cmd while composing 

6.6.10 Placing a Tilde at the Beginning of a Line: ~~ 

If you wish to send a message that contains a line beginning with a tilde, you 
must type it twice. For example, typing 

" "This line begins with a tilde. 

appends 

"This line begins with a tilde. 

to your message. The escape character can be changed to a different character 
with the etc apt option. (For information on how to set options, see section 6.7, 
"Setting Up Your Mail Environment". If the escape character is not a tilde, 
then this discussion applies to that character and not the tilde. 

6.7 Setting Up Your Environment: The .mailrc File 

Whenever mail is invoked, it first reads the file fuer/lib/ mail/ mailrc then the 
file .mailrc in the user's home directory. System-wide aliases are defined in 
fuer/lib/ mail/ mailrc. Personal aliases and set options are defined in .mailrc. 
The following is a sample .mailrc file: 

# number sign introduces comments 

# personal aliases office and cohorts are defined below 

alias office bill steve karen 

alias cohorts John mary bob beth mike 

# set dot lets messages be terminated by period on new line 

# set askcc says to prompt for Cc: list after composing message 
set dot askcc 

# cd changes directory to different current directory 
cd 

6.7.1 The Subject prompt: asksubject 

The aekeubject switch causes prompting for the subject of each message before 
you enter compose mode. If you respond to the prompt with a RETURN, then 



6-26 



Mail 

no subject field is sent. 

6.7.2 The CQi prompt; aslccc 

The aekcc switch causes prompting for additional carbon copy recipients when 
you finish composing a message. Responding with a RETURN signals your 
satisfaction with the current list. Pressing INTERRUPT prints 

interrupt 
(continue) 

so that you can return to editing your message. 



6.7.3 Printing the Next Message: autoprint 

This switch causes the delete command to behave like dp. After deleting a 
message, the next message in the list is automatically printed. Printing also 
occurs automatically after execution of an undelete command. 



6.7.4 Listing Messages in Chronological Order: chron and 
mchron 

The chron switch causes messages to be listed in chronological order. By 
default, messages are listed with the most recent first. Set chron when you want 
to read a series of messages in the order they were received. 

The mchron switch, like thron, prints messages in chronological order, but lists 
them in the opposite order, i.e. highest-numbered, or most recent, first. This is 
useful if you keep a large number of messages in your mailbox and you wish to 
list the headers of the most recently received mail first but read the messages 
themselves in chronological order. 



6.7.5 Using the Period to Send a Message: dot 

The dot switch lets you use a period (.) as an end-of-transmission character, as 
well as CNTRL-D. This option is available for those who are used to this 
convention when editing with the editor, e d. 



6.7.6 Including Yourself in a Group: metoo 

Usually, when a group is expanded that contains name of the sender, the sender 
is removed from the expansion. Setting the met oo option causes the sender to be 
included in the group. 
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8.7.7 Saving Aborted Messages: save 



The notave switch prevents aborted messages from being appended to the file 
iead.letterlnyour home directory; messages are saved by default. Messages are 
aborted when in compose mode by typing either two interrupts or a "q compose 
escape. 



6.7.8 Printing the Version Header: quiet 

The quiet switch suppresses the printing of "<n> messages:" before the 
header-list and suppresses printing of the version header when mail is first 
invoked. 



6.7.9 Choosing an Editor: The EDITOR String 

The EDITOR string contains the pathname of the text editor to use in the edit 
command and ~e escape. If not defined, then the default editor is used. For 
example: 

set EDITOR=/bin/ed 

6.7.10 Choosing an Editor: The VISUAL String 

The VISUAL string contains the pathname of the text editor used in the visual 
command and "v escape. For example: 

set VISUAL—/bin/vi 

By default vi is the editor used. 

6.7.11 Choosing a Shell: The SHELL String 

The SHELL string contains the name of the shell to use in the ! command and 
the ~! escape. A default shell is used if this option is not defined. For example: 

set SHELL=/bin/sh 

6.7.12 Changing the Escape Character: The escape String 

The escape string defines the character to use in place of the tilde {") to denote 
compose escapes. For example: 

set escape=* 
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With this setting, the asterisk becomes the new compose escape character. 

6.7.13 Setting Page Size: The page String 

The page string causes messages to be displayed in pages of size n lines. You are 
prompted with a question mark between pages. Pressing RETURN causes the 
next page of the current message to be printed. By default this paging feature is 
turned off. 

6.7.14 Saving Outgoing Mail: The record String 

The recorrfstring sets the pathname Of the file used to record all outgoingmail. 
If not defined, then outgoing mail is not copied and saved. For example: 

set record=/usr/john/recordfile 

With this setting, all outgoing mail is automatically appended to the file 
/ uer/john/ rec ordfile. 



6.7.15 Keeping Mail in the System Mailbox: autombox 

The autombox switch determines whether messages remain in the system 
mailbox when you exit mail. If you set autombox, examined messages are 
automatically placed in the mbox file in your home directory (your user 
mailbox) and re moved from the system mailbox when you quit. 



6.7.16 Changing the top Value: The toplines String 

The toplinee string sets the number of lines of a message to be printed out with 
the top command. By default, this value is five. For example: 

set toplines=10 

With this setting, ten lines of each message are printed out when the top 
command is used. 



6.7.17 Sending Mail Over Telephone Lines: ignore 

The ignore switch causes interrupt signals from your terminal to be ignored 
and echoed as at-signs (@). This switch is normally used only when 
communicating with mail over telephone lines. 
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6.8 Using Advanced Features 

This section discusses advanced features of mail useful to those with some 
existing familiarity with the XENIX mail system. 



6.8.1 Command Line Options 

One very useful command line option to mail is the -s "subject" switch. With 
this switch you can specify a subject on the command line. For example, you 
could send a file named letter with the subject line, "Important Meeting at 
12:00", by typing the following: 

mail -s "Important Meeting at 12:00" John bob mike < letter 

To include other header fields in your message, you can use the following 
options: 

^R Makes the mail session "read-only", preventing alteration of the mail 
being read. 

-b Adds the blind carbon copy field to the message header. 

-c Adds the carbon copy field to the message header. 

-r Adds the return-receipt to: field to the message header. 

-u Reads in ueer'e mail. 

Mail also allows you to edit files of messages by using the -f switch on the 
command line. For example, 

mail -f filename 

causes mail to edit Rename and 

mail -f 

causes mail to read mbox in your home directory. All the mail commands 
except hold are available to edit the messages. When you type the quit 
command, mail writes the updated file back. 

If you send mail over a noisy phone line, you may notice that bad characters are 
transmitted. Many of these will be the character that aborts messages: the 
RUBOUT or DEL character. To ignore these bad characters, invoke mail with 
the -i switch. 
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6.8.2 Using Mail as a Reminder Service 

Besides sending and receiving mail, you can use mail as a reminder service. 
Several XENIX commands have this idea built in to them. For example, the 
XENIX lpr command's -m switch causes mail to be sent to the user after files 
have been printed on the lineprinter. XENIX automatically examines the file 
named calendar in each user's home directory and looks for lines containing 
either today or tomorrow's date. These lines are sent by mail as reminder of 
important events. 

If you program in the shell command language, you can use mail to signal the 
completion of a job. For example, you might place the following two lines in a 
shell procedure: 

biglongjob 

echo "biglongjob done" | mail self 

You can also create a a logfile that you want to mail to yourself. For example, 
you might have a shell procedure that looks like this: 

dosomething > logfile 
mail self < logfile 

For information about writing shell procedures, see Chapter 7 of this manual, 
"The Shell". 



6.8.3 Handling Large Amounts of Mail 

Eventually, you will face the problem of dealing with an accumulation of 
messages in your user mailbox. There are a number of strategies that you can 
employ to handle this flood of information. Keep in mind the dictum: 

When in doubt, throw it out. 

This means that you should only save important mail in your user mailbox. If 
your mailbox file becomes large, you must periodically examine its contents to 
decide whether messages are still relevant. For very long messages, consider 
replacing message contents with summaries. 

Even the above measures are not usually help enough in organizing the many 
messages you are likely to receive. One effective approach is to save mail in files 
organized by sender, by topic, or by a combination of the two. Create these files 
in a separate mail directory; you can access these mailbox files with the mail -f 
filename switch. However, be forewarned — this approach to organizing mail 
quickly eats up disk space. 
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6.8.4 Maintenance and Administration 

The following is a list of the programs and files that make up the XENIX mail 
system: ';. 

/usr/bin/mail Mail program 

/usr/lib/mail/mailrc Mail system initialization file 

/usr /spool/mail/* System mailbox files 

/usr/name/mbox User mailbox 

/usr/name/.mailrc User mail initialization file 

/usr/lib/mail/rnailhelp.cmd Mail command help file 

/usr/lib//mail/mailhelp.esc Mail compose escape help file 

/usr/lib/mail/mailhelp.set Mail option help file 

/usr/lib/mail/mailaliases System-wide aliases 

/etc/newaliases Program to produce database files from 

/usr/ lib/ mail/ aliaees 

A system-wide distribution list is kept in /usr/ lib/ mail/ aliaees. A system 
administrator is usually in charge of this list. These aliases are kept in a vastly 
different syntax from .mailre, and are expanded when mail is sent. You will 
normally need special permission to change system-wide aliases. 

6.9 Quick Reference 

The following sections give provide quick reference to the available commands, 
compose escapes, and options. 

6.0.1 Command Summary 

Given below are the name and syntax for each command, its abbreviated form 
(in brackets), and a short description. Many commands have optional 
arguments; most can be executed without any arguments at all. In particular, 
commands that take a message-list argument default will to the current 
message if no message-list is .given. In the following descriptions, boldface 
denotes the name of a command, compose escape or option. Italics are used for 
arguments to commands or compose escapes. The vertical bar indicates 
selection and is used to separate the arguments from which you may select. All 
other text should be read literally. 
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RETURN 

+ n 



lehell-emd 

Alias 

alias name ueer$ 

cd directory 

delete meeg-liet 
dp meeg-liet 

echo 

edit meeg-liet 

exit[!] , 
file filename 



Prints the next message. 

{+] With no n argument, goes to the next message and 
prints it. If given a numeric argument n, goes to the nth 
message and prints it. 

[-] With no n argument, goes to the previous message 
and prints it. If given a numeric argument n, goes to the 
nth previous message and prints it. 

Prints the first message. 

Prints the last message. 

Prints the message number of the current message. 

Prints the summary of mail commands in 
/uer/lib/ m ail/ mailhelp, e md. 

Executes the shell command that follows. No space is 
needed after the exclamation point. 

Prints system-wide aliases for users. 

[a] Aliases ueere to name. With no name arguments, 
prints all currently defined aliases. With one argument, 
prints the users aliased by the given name argument. 

[c] Changes the user's working directory to the 
specified directory. If no directory is given, then 
changes to the user's home directory. 

[d] Deletes each message in the given message-list. 

Deletes the current message and prints the next 
message. 

Expands shell metacharacters. 

|e] Takes the given message-list and points the text 
editor at each message in turn. On return to command 
mode, the edited message is read back in. See also the 
visual command. 

[x ] Immediately returns to the shell without modifying 
the system mailbox, the user mailbox, or a file specified 
with the -f switch. 

[fi] Prints the name of the mailbox file. 
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forward meeg-num ueer-liet 

[fj Takes a ueer-liet argument and forwards the 
current message to each name. The message sent to 
each is indented and shows that the sender has passed it 
on. The meeg-num argument is optional, and is used to 
forward the numbered message instead of the default 
message. 

Forward meeg-num ueer-liet 

[F] Same as forward except that the message is not 
indented. 

headers + n\-n\ meeg-liet 

(h] With no argument, lists the current range of 
headers, which is an 18- message group. If a plus (+) 
argument is given, then the next 18-message group is 
printed, and if a minus (-) argument is given, the 
previous 18-message group is printed. Both plus and 
minus accept an optional numeric argument indicating 
the number of header-windows to move forward or 
backward. If a message-list is given, then the message- 
header for each message in the list is printed. 

hold meeg-liet [ho] Takes a message-list and marks each message to 

be saved in the user's system mailbox instead of in 
mbox. 

list Prints list of mail commands, mbox. Does not 

override the delete command. Not useful unless the 
automb ox option is set. 

lpr meeg-liet [1] Prints each of the messages in the required 

message-list on the lineprinter. Messages are piped 
through pr before being printed. 

mail fueer-lietj [m] Takes an optional user-list argument and sends 

mail to each name after entering compose mode. 

«nbox meeg-liet (*nb] Marks messages given in the message-list 

argument to be saved in the user mailbox when a quit is 
executed. Message headers contain an initial letter "M" 
to show that they are to be saved. 

move meeg-liet meeg-num Places the messages specified in meeg-liet after the 
message specified in meeg-num. If meeg-num is 0, 
meeg-liet moves to the top of the mailbox. 

print meeg-liet [pjTakesamessage-listandprintseachmessageonthe 

user's terminal. 
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quit 



reply meeg-liet 
Reply meeg-liet 



[q] Terminates the mail session, retaining all 
nondeleted, unsaved messages in the system mailbox. 
If the' autombox option is set, then examined messages 
are saved in the user mailbox, deleted messages are 
discarded, and all messages marked with the hold 
command are retained in the system mailbox. 

If you are executing a quit while editing a mailbox file 
with the -f flag, the mailbox file is rewritten and the 
user returns to the shell. 

[r] Takes a message- list and sends mail to each message 
author just like the mail command. 

[R] Identical to the reply command except that replies 
are also sent to other users in the To: and those named 
in the Ce: field. 



save meeg-liet filename 



set 

set option-liet 



shell 

size meeg-liet 

source file 

top 

string 

undelete meeg-liet 



[s] Takes an optional message-list and a filename and 
appends each message in turn to the end of the file. The 
default message is the current message. 

[se ] Prints list of available options. 

[se] With no arguments, prints all variable values. 
Otherwise, sets option. Arguments are of the form 
option=value, if. the option is a string option or just 
option, if the option is a switch. Multiple options may 
be set on one line. 

[sh ] Invokes an interactive version of the shell. 

[si] Takes a message- list and prints the size in 
ch ar acter s of e ach message . 

[so] Reads and executes mail commands from the 
given file. 

[t] Takes a message- list and prints the top five lines. 
The number of lines printed is set by the variable 
toplinee. 

Searches for et rin g in meeg-liet Ignores case in search. 

[u] Takes a message-list and marks each one as not 
being deleted. Each message in the list must previously 
have been deleted. 
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unset options [uns] Takes a list of option names and discards their 

remembered values; this is the opposite of set. 

visual meeg-liet [v] Takes a message-list and invokes the tt editor on 

each one. 

write meeg-liet filename 

[wj Writes the message bodies of messages given by the 
message-list to the file given by filename. 



6.0.2 Compose Escape Summary 

Compose escapes are used when composing messages to perform special 
functions. They are only recognized at the beginning of lines. The escape 
character can be set with the escape string option.(See section 6.7.14, "The 
escape String".) Abbreviations for each escape are in brackets. 

Here is a summary of the compose escapes: 

tiring Inserts the string of text in the message prefaced by a single 

tilde ("). 

~? Prints out help for compose escapes on terminal. 

Same as CNTRL-D on a new line. 

" Icommand Executes a shell command, then returns to compose mode. 

'{command Pipes the message body through the command as a filter. 

Replaces the message body with the output of the filter. If 
the command gives no output or terminates abnormally, 
retains the original message body. 

* _mail- command Executes a mail command, then returns to compose mode. 

~ -.mail- command Executes a mail command, then returns to compose mode. 

"" alias [~a] Prints list of private aliases. * 

"alias aliaename [~a]Printsnames included in private aliaename. 

"alias aliatname ueere 

|~a] Adds ueereto private aliaename list. 

"Alias [~ A] Prints list of system- wide aliases. 

"Alias were ("A] Prints system- wide aliases for ueere. 
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"bcc name ... ("bjAddsthegivennamestothei?ce:field. 

"ccname... [ "cj Adds the given name to the ce: field. 

"dead (~d) Reads the file dead.Utter from your home directory 

into the message. 

"editor |"e] Invokes the line editor on the message being sent. 

Exiting the editor returns the user to compose mode. 

"headers [~h] Edits the message heading fields by printing each one in 

turn and allowing the user to modify each field. 

"message me$g-Uet 

(~m] Reads the named messages into the message being 
sent, shifted right one tab. If no messages are specified, reads 
the current message. 

"Message me eg -list { ~M] Same as "message except with no rightshift. 

"print ("p] Prints the message buffer prefaced by the message 

heading. 

"quit [ ~q] Aborts the message being sent, copying the message to 

dead.Utter inyour home directory if the save option is set. 

"read filename [ "r] Reads the named file into the message. 

"Return name ["R] Adds the given names to the Ret urn-re ceipt-to: field. 

"shell j~sh] Invokes a shell. 

"subject string [ "sj Causes the named string to become the current subject 
field. 

"to name... ["t]Addsthe given names to the To.'field. 

"visual |"v] Invokes the vi editor to edit the message buffer. 

Exiting the editor returns the user to compose mode. 

"write filename ("w J Writes the message body to the named file. 
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6.0.3 Option Summary 

Options are controlled with the set and unset commands. An option is either a 
switch or a string. A switch is either on or off, while a string option has a value 
that is a pathname, a number, or a single character. Options are summarized 
below. 

askcc Causes prompting for additional carbon copy recipients at the 

end of each message. Pressing RETURN retains the current list. 

asksubject Causes prompting for the subject of each message you send. 
The subject is a line of text terminated by a RETURN. 

auto m box Usually messages are retained in the system mailbox when the 
user quits. However, if this option is set, examined messages 
are automatically appended to the user mailbox. 

autoprint Causes the delete command to behave like dp. Thus, after 
deleting (or undeleting) a message, the next one is printed 
automatically. 

chron Causes messages to be listed in chronological order. 

dot Causes a single period on a newline to act as the EOT character. 

The normal end-of-transmission character, CNTRL-D, still 
works. 

EDITOR= Pathname of the text editor to use in the edit command and "e 
escape. If not defined, then a default editor is used. 

escape char If denned, sets char as the character sets the character to Use in 
place of the tilde (") to denote compose escapes. 

ignore Causes interrupt signals from your terminal to be ignored and 

echoed as at-signs(@). 

mchron Causes messages to be listed in numerical order (most recently 

received first), but displayed in chronological order. 

metoo Normally, before sending, the name of the sender is removed 

from alias expansions. If metoo is set, then the name of the 
sender is not removed. 

nosave Prevents saving of the message buffer in the file dcad.letter in 

the home directory, after two consecutive interrupts or a ~q 
escape. 

page=n Specifies the number of lines (n) to be printed in a"page" of text 

when displaying messages. 
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quiet Suppresses the printing of the version when mail is first 

invoked. 

record= Sets the pathname of the file used to record all outgoing mail. If 
not defined, then outgoing mail is not copied. 

SHELL= Pathname of the shell to use in the! command and the"! escape. 
A default shell is used if this option is not defined. 

toplines= Sets the number of lines of a message to be printed with the top 
command. Default is five lines. 

VISUAL= Pathname of the text editor to use in the visual command and 
"v escape. The default is for the vi editor. 
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7.1 Introduction 



When users log into XENIX, they communicate with the shell command 
interpreter, sh. This interpreter is a XENIX program that supports a very 
powerful command language. Each invocation of this interpreter is called a 
shell; and each shell has one function: to read and execute commands from its 
standard input. 

Because the shell gives the user a high-level language in which to communicate 
with the operating system, XENIX can perform tasks unheard of in less 
sophisticated operating systems. Commands that would normally have to be 
written in a traditional programming language can be written with just a few 
lines in a shell procedure. In other operating systems, commands are executed 
in strict sequence. With XENIX and the shell, commands can be: 

Combined to form new commands 
Passed positional parameters 
Added or renamed by the user 
Executed within loops or executed conditionally 
Created for local execution without fear of name conflict with other 
user commands 
• Executed in the background without interrupting a session at a 
terminal 

Furthermore, commands can "redirect" command input from one source to 
another and redirect command output to a file, terminal, printer, or to another 
command. This provides flexibility in tailoring a task for a particular purpose. 



7.2 Basic Concepts 

The shell itself (i.e., the program that reads your commands when you log in or 
that is invoked with the sh command) is a program written in the C language; it 
is not part of the operating system proper, but an ordinary user program. 



7.2.1 How Shells Are Created 

In XENIX, a process is an executing entity complete with instructions, data, 
input, and output. All processes have lives of their own, and may even start (or 
"fork") new processes. Thus, at any given moment several processes may be 
executing, some of which are "children" of other processes. 

Users log into the operating system and are assigned a "shell" from which they 
execute. This shell is a personal copy of the shell command interpreter that is 
reading commands from the keyboard: in this context, the shell is simply 
another process. 

In the XENIX multitasking environment, files may be created in one phase and 
then sent off to be processed in the "background." This allows the user to 
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continue working while programs are running. 

7.2.2 Commands 

The most common way of using the shell is by typing simple commands at your 
keyboard. A eimple command is any sequence of arguments separated by 
spaces or tabs. The first argument (numbered zero) specifies the name of the 
command to be executed. Any remaining arguments, with a few exceptions, are 
passed as arguments to that command. For example, the following command 
line might be typed to request printing of the files atfan, barry, and calvin: 

lpr allan barry calvin 

If the first argument of a command names a file that is executable (as indicated 
by an appropriate set of permission bits associated with that file) and is actually 
a compiled program, the shell, as parent, creates a child process that 
immediately executes that program. If the file is marked as being executable, 
but is not a compiled program, it is assumed to be a shell procedure, i.e., a file of 
ordinary text containing shell command lines. In this case, the shell spawns 
another instance of itself (a eubehell) to read the file and execute the commands 
inside it. 

From the user's viewpoint, compiled programs and shell procedures are 
invoked in exactly the same way. The shell determines which implementation 
has been used, rather than requiring the user to do so. This provides uniformity 
of invocation. 



7.2.3 How the Shell Finds Commands 

The shell normally searches for commands in three distinct locations in the file 
system. The shell attempts to use the command name as given; if this fails, it 
prepends the string /bin to the name. If the latter is unsuccessful, it prepends 
/iter/ bin to the command name. The effect is to search, in order, the current 
directory, then the directory /bin, and finally, /uer/bin. For example, the pr 
and man commands are actually the files (bin/pr and /iter/ bin/ man, 
respectively. A more complex pathname may be given, either to locate a file 
relative to the user's current directory, or to access a command with an 
absolute pathname. If a given command name begins with a slash (/) (e.g., 
/bin/eort or /cmd), the prepending is not performed. Instead, a single attempt 
is made to execute the command as named. 

This mechanism gives the user a convenient way to execute public commands 
and commands in or near the current directory, as well as the ability to execute 
any accessible command, regardless of its location in the file structure. Because 
the current directory is usually searched first, anyone can possess a private 
version of a public command without affecting other users. Similarly, the 
creation of a new public command does not affect a user who already has a 
private command with the same name. The particular sequence of directories 
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searched may be changed by resetting the shell PATH variable. (Shell variables 
are discussed later in this chapter). 



7.2.4 Generation of Argument Lists 

The arguments to commands are very often filenames. Sometimes, these 
filenames have similar, but not identical, names. To take advantage of this 
similarity in names, the shell lets the user specify patterns that match the 
filenames in a directory. If a pattern is matched by one or more filenames in a 
directory, then those filenames are automatically generated by the shell as 
arguments to the command. 

Most characters in such a pattern match themselves, but there are also XENIX 
special characters that may be included in a pattern. These special characters 
are: the star (*), which matches any string, including the null string; the 
question mark (?), which matches any one character; and any sequence of 
characters enclosed within brackets ([ and ]), which matches any one of the 
enclosed characters. Inside brackets, a pair of characters separated by a dash 
(-) matches any character within the range of that pair. Thus [a-dej is 
equivalent to [abcdej. 

Examples of metacharacter usage: 

* (Matches all names in the current directory) 

*temp* (Matches all names containing "temp") 

[a-f]* (Matches all names beginning wttA"a" through" f) 

*.c (Matches all names ending in n .c") 

/usr/bin/? (Matches all single-character names in /usr/bin) 

This pattern-matching capability saves typing and, more importantly, makes 
it possible to organize information in large collections of files that are named in 
a structured fashion, using common characters or extensions to identify related 
files. 

Pattern matching has some restrictions. If the first character of a filename is a 
period (.), it can be matched only by an argument that literally begins with a 
period. If a pattern does not match any filenames, then the pattern itself is 
printed out as the result of the match. 

Note that directory names should not contain any of the following characters: 

•Ml 

If these characters are used, then infinite recursion may occur during pattern 
matching attempts. 
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7.2.5 Quoting Mechanisms 

The characters < , > ,*,?,L and G have special meanings to the shell. To remove 
the special meaning of these characters requires some form of quoting. This is 
done by using single quotation marks or double quotation marks (") to 
surround a string. A backslash (\) before a single character provides this 
function. (Back quotation marks ( v ) are used only for command substitution in 
the shell and do not hide the special meanings of any characters.) 

All characters within single quotation marks are taken literally. Thus 

echostuff= echo $? $*; Is * | wc ' 
results in the string 

echo $? $*; Is * | wc . 

being assigned to the variable echoetuff, but it does not result in any other 
commands being executed. 

Within double quotation marks, the special meaning of certain characters does 
persist, while all other characters are taken literally. The characters that 
retain their special meaning are the dollar sign ($), the backslash (\), the single 
quotation mark ( '), and the double quotation mark (" ) itself. Thus, within 
double quotation marks, variables are expanded and command substitution 
takes place (both topics are discussed in later sections). However, any 
commands in a command substitution are unaffected by double quotation 
marks, so that characters such as star (*) retain their special meaning. 

To hide the special meaning of the dollar sign ($) and single and double 
quotation marks within double quotation marks, precede these characters with 
a backslash (\). Outside of double quotation marks, preceding a character with 
a backslash is equivalent to placing single quotation marks around that 
character. A backslash (\) followed by a newline causes that newline to be 
ignored and is equivalent to a space. The backslash-newline pair is therefore 
useful in allowing continuation of long command lines. 

Some examples of quoting are shown below : 
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Input 


Shell interprets as: 


'» * 


The back quotation mark ( ') 


'Yl ' 


The double quotation mark (") 


' v echo one 


the one word " 'echo one * 


v \n » 


The double quotation mark (") 


" 'echo one * " 


the one word "one" 


n »n 


illegal (expects another ' ) 


one two 


the two words "one" & "two" 


"one two" 


the one word "one two" 


one two' 


the one word "one two" 


one * two' 


the one word "one * two" 


"one * two" 


the one word "one * two" 


'echo one' 


the one word "one" 



7.3 Redirecting Input and Output 

In general, most commands do not know or care whether their input or output 
is coming from or going to a terminal or a file. Thus, a command can be used 
conveniently either at a terminal or in a pipeline. A few commands vary their 
actions depending on the nature of their input or output, either for efficiency, 
or to avoid useless actions (such as attempting random access I/O on a terminal 
or a pipe). 



7.3.1 Standard Input and Output 

When a command begins execution, it usually expects that three files are 
already open: a "standard input", a "standard output", and a "diagnostic 
output", (also called "standard error"). A number called a file deteriptor'is 
associated with each of these files. By convention, file descriptor is associated 
with the standard input, file descriptor 1 with the standard output, and file 
descriptor 2 with the diagnostic output. A child process normally inherits these 
files from its parent; all three files are initially connected to the terminal (0 to 
the keyboard, 1 and 2 to the terminal screen). The shell permits the files to be 
redirected elsewhere before control is passed to an invoked command. 

An argument to the shell of the form "<file" or ">/Ke" opens the specified file 
as the standard input or output (in the case of output, destroying the previous 
contents of file, if any). An argument of the form ">>file" directs the 
standard output to the end of file, thus providing a way to append data to the 
file without destroying its existing contents. In either of the two output cases, 
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the shell creates file if it does not already exist. Thus 

>output 

alone on a line creates a zero-length file. The following appends to file log the 
list of users who are currently logged on: 

who >> log 

Such redirection arguments are only subject to variable and command 
substitution; neither blank interpretation nor pattern matching of filenames 
occurs after these substitutions. This means that 

echo 'this is a test' > *.gal 

produces a one-line file named *. gal. Similarly, an error message is produced by 
the following command, unlessyou have a file with the name "?": 

cat < ? 

So remember, special characters are not expanded in redirection arguments. 
The reason this is so is that redirection arguments are scanned by the shell 
before pattern recognition and expansion takesplace. 

7.3.2 Diagnostic and Other Outputs 

Diagnostic output from XENIX commands is normally directed to the file 
associated with file descriptor 2. (There is often a need for an error output file 
that is different from standard output so that error messages do not get lost 
down pipelines.) You can redirect this error output to a file by immediately 
prepending the number of the file descriptor (2 in this case) to either output 
redirection symbol (> or >>). The following line appends error messages 
from the cc command to the file named ERRORS: 

cc testfile.c 2>>ERRORS 

Note that the file descriptor number must be prepended to the redirection 
symbol without any intervening spaces or tabs; otherwise, the number will be 
passed as an argument to the command. 

This method may be generalized to allow redirection of output associated with 
any of the first ten file descriptors (numbered 0-9). For instance, if cmrf puts 
output on file descriptor 9, then the following line will direct that output to the 
file save data: 

cmd 9 > save data 

A command often generates standard output and error output, and might even 
have some other output, perhaps a data file. In this case, one can redirect 
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independently all the different outputs. Suppose, for example, that emrfdirects 
its standard output to file descriptor 1, its error output to file descriptor 2, and 
builds a data file on file descriptor 9. The following would direct each of these 
three outputs to a different file: 

cmd >standard 2>error 9>data 



7.3.3 Command Lines and Pipelines 

A sequence of commands separated by the vertical bar ( | ) makes up a pipeline . 
In a pipeline consisting of more than one command, each command is run as a 
separate process connected to its neighbors by pipee, that is, the output of each 
command (except the last one) becomes the input of the next command in line. 

A filter is a command that reads its standard input, transforms it in some way, 
then writes it as its standard output. A pipeline normally consists of a series of 
filters. Although the processes in a pipeline are permitted to execute in parallel, 
each program needs to read the output of its predecessor. Many commands 
operate on individual lines of text, reading a line, processing it, writing it out, 
and looping back for more input. Some must read large amounts of data before 
producing output; sort is an example of the extreme case that requires all input 
to be read before any output is produced. 

The following is an example of a typical pipeline: 

nroff -mm text | col | lpr 

Nfoflf is a text formatter available in the XENIX Text Processing System whose 
output may contain reverse line motions, col converts these motions to a form 
that can be printed on a terminal lacking reverse-motion capability, and lpr 
does the actual printing. The flag -mm indicates one of the commonly used 
formatting options, and text is the name of the file to be formatted. 

The following examples illustrate the variety of effects that can be obtained by 
combining a few commands in the ways described above. It may be helpful to 
try these at a terminal: 

• who 

Prints the list of logged- in users on the terminal screen. 

• who > > log 

Appendsthelistoflogged-inuserstotheendoffile/o;. ; 

■■•■ who | wc -1 

Prints the number of logged-ih users. (The argument to wc is 
pronounced "minus ell".) 
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• whojpr 

Prints a paginated list of logged? in users. 

• who | sort 

Prints an alphabetized list of logged- in users. 

• who | grep bob 

Prints the list of logged-in users whose login names contain the string 
bob. 

• who | grep bob | sort | pr 

Prints an alphabetized, paginated list of logged-in users whose login 
names contain the string bob. 

f { date; who | wc-1; } >>log 

Appends (to file log ) the current date followed by the count of logged- 
in users. Be sure to place a space after the left brace and a semicolon 
before the right brace. 

• who|sed-e 's/ .*// '|sort|uniq-d 

Prints only the login names of all users who are logged in more than 
once. Note the use of seel as a filter to remove characters trailing the 
login name from each line. (The ".*" in the sed command is preceded 
by a space.) 

The who command does not by itself provide options to yield all these 
results — they are obtained by combining who with other commands. Note 
that who just serves as the data source in these examples. As an exercise, 
replace "who | "with "</etc/passwd" in the above examples to see how a file 
can be used as a data source in the same way. Notice that redirection 
arguments may appear anywhere on the command line, even at the start. This 
means that 

< in file >outfile sort|pr 

is the same as 

sort|pr <infile >outfile 



7.3.4 Command Substitution 

Any command line can be placed within back quotation marks (\ . .*) so that 
the output of the command replaces the quoted command line itself. This 
concept is known as command substitution. The command or commands 
enclosed between back quotation marks are first executed by the shell and then 
their output replaces the whole expression, back quotation marks and all. This 
feature is often used to assign to shell variables. (Shell variables are described 
in the next section.) For example, 
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today = Mate' 

assigns the string representing the current date to the variable "today"; for 
example "Tue Nov 27 16:01:08 EST 1982". The following command saves the 
number of logged-in users in the shell variable ueer$ : 

users='who | wc -V 

Any command that writes to the standard output can be enclosed in back 
quotation marks. Back quotation marks may be nested, but the inside sets 
must be escaped with backslashes ( \ ). For example: 

logmsg='echo Your login directory is \*pwd\ x " 

will display the line "your login directory is name of login directory". Shell 
variables can also be given values indirectly by using the read and line 
commands. The read command takes a line from the standard input (usually 
your terminal) and assigns consecutive words on that line to any variables 
named. 

Forexamplei 

read first init last 
takes an input line of the form 

G. A. Snyder 
and has the same effect as typing: 

first=G. init=A. last=Snyder 

The read command assigns any excess "words" to the last variable. 

The line command reads a line of input from the standard input and then 
echoes it to the standard output. 

7.4 Shell Variables 

The shell has several mechanisms for creating variables. A variable is a name 
representing a string value. Certain variables are referred to as positional 
parameter$; these are the variables that are normally set only on the command 
line. Other shell variables are simply names to which the user or the shell itself 
may assign string values. 
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7.4.1 Positional Parameters 

When a shell procedure is invoked, the shell implicitly creates poeitional 
parameters. The name of the shell procedure itself in position zero on the 
command line is assigned to the positional parameter $0. The first command 
argument is called $1, and so on. The shift command may be used to access 
arguments in positions numbered higher than nine. For example, the following 
shell script might be used to cycle through command line switches and then 
process all succeeding files: 

while test tl ' 

do case $1 in 

-a) A=aoption ; shift ;; 

-b) B=boption ; shift ;; 

-c) C=coption ; shift ;; 

-*) echo "bad option" ; exit 1 ;; 

*•) process rest of files 

esac 
done 

One can explicitly force values into these positional parameters by using the set 
command. For example, 

set abc def ghi 

assigns the string "abc" to the first positional parameter, $1, the string "def to 
$2, and the string "ghi" to $3. Note that $0 may not be assigned a value in this 
way — it always refers to the name of the shell procedure; or in the login shell, to 
the name of the shell. 



7.4.2 User-Defined Variables 

The shell also recognizes alphanumeric variables to which string values may be 
assigned. Asimple assignment has the syntax: 

name= string 

Thereafter, %name will yield the value string. A name is a sequence of letters, 
digits, and underscores that begins with a letter or an underscore. No spaces 
surround the equal sign (=) in an assignment statement. Note that positional 
parameters may not appear on the left side of an assignment statement; they 
can only be set as described in the previous section. 

More than one assignment may appear in an assignment statement, but 
beware: the ehell performs the assignments from right to left. Thus, the 
following command line results in the variable "A" acquiring the value "abc": 
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A=$B B=abc 

The following are examples of simple assignments. Double quotation marks 
around the right-hand side allow spaces, tabs, semicolons, and newlines to be 
included in a string, while also allowing variable substitution (also known as 
"parameter substitution") to occur. This means that references to positional 
parameters and other variable names that are prefixed by a dollar sign ($) are 
replaced by the corresponding values, if any. Single quotation marks inhibit 
variable substitution: 

MAIL=/usr/mail/gas 
echovar="echo $1 $2 $3 $4" 
stars=****** 
asterisks='$stars' 

In the above example, the variable "echovar" has as its value the string 
consisting of the values of the first four positional parameters, separated by 
spaces, plus the string "echo". No quotation marks are needed around the 
string of asterisks being assigned to $tar$ because pattern matching (expansion 
of star, the question mark, and brackets) does not apply in this context. Note 
that the value of $a8terieke is the literal string ' '$stars", not the string "*****", 
because the single quotation marks inhibit substitution. 

In assignments, spaces are not re-interpreted after variable substitution, so 
that the following example results in $fir$t and $«econ</having the same value: 

first= a string with embedded spaces' 
second=$first 

In accessing the values of variables, you may enclose the variable name in 
braces {...} to delimit the variable name from any following string. In 
particular, if the character immediately following the name is a letter, digit, or 
underscore, then the braces are required. For example, examine the following 
input: 

a= 'This is a string ' 

echo "${a}ent test of variables." 

Here, the echo command prints: 

This is a stringent test of variables. 

If no braces were used, the shell would substitute a null value for "$aent" and 
print: 

test of variables. 
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The following variables are maintained by the shell. Some of them are set by 
the shell, and all of them can be reset by the user : 

HOME Initialized by the login program to the name of the user's login 
directory, that is, the directory that becomes the current 
directory upon completion of a login; cd without arguments 
switches to the $HOME directory. Using this variable helps keep 
full pathnames out of shell procedures. This is of great benefit 
when pathnames are changed, either to balance disk loads or to 
reflect administrative changes. 

IFS The variable that specifies which characters are internal field 

separators. These are the characters the shell uses during blank 
interpretation. (If you want to parse some delimiter-separated 
data easily, you can set IFS to include that delimiter.) The shell 
initially sets IFS to include the blank, tab, and newline characters. 

MAIL The pathname of a file where your mail is deposited. If MAIL is 
set, then the shell checks to see if anything has been added to the 
file it names and announces the arrival of new mail each time you 
return to command level (e.g., by leaving the editor). MAIL must 
be set by the user and "exported". (The export command is 
discussed later in this chapter.) (The presence of mail in the 
standard mail file is also announced at login, regardless of whether 
MAIL is set.) 

PATH The variable that specifies the search path used by the shell in 
finding commands. Its value is an ordered list of directory 
pathnames separated by colons. The shell initializes PATH to the 
list :/bin:/usr/bin where a null argument appears in front of the 
first colon. A null anywhere in the path list represents the current 
directory. On some systems, a search of the current directory is 
not the default and the PATH variable is initialized instead to 
fbin:/xier/bin. If you wish to search your current directory last, 
rather than first, use: 

PATH=/bin:/usr/bin:: 

Here, the two colons together represent a colon followed by a null, 
followed by a colon, thus naming the current directory. You could 
possess a personal directory of commands (say, %HOME/bin) and 
cause it to be searched before the other three directories by using: 

PATH=$HOME/bin::/bin:/usr/bin 

"PATH" is normally set in your .profile file. 

PSl The variable that specifies what string is to be used as the primary 
prompt string. If the shell is interactive, it prompts with the value 
of PSl when it expects input. The default value of PSl is "$ " (a 
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dollar sign ($) followed by a blank). 

PS2 The variable that specifies the secondary prompt string. If the 
shell expects more input when it encounters a newline in its input, 
it prompts with the value of PS2. The default value for this 
variable is "> " (a greater-than symbol followed by a space). 

In general, you should be sure to export all of the above variables so that their 
values are passed to all shells created from your login. Use export at the end of 
your . profile file. An example of an export statement follows: 

export HOME IFS MAIL PATH PS1 PS2 



7.4.3 Predefined Special Variables 

Several variables have special meanings; the following are set onlyby the shell: 

$# Records the number of arguments passed to the shell, not counting 
the name of the shell procedure itself. For instance, $# yields the 
number of the highest set positional parameter. Thus 

sh cmd a b c 

automatically sets $# to 3. One of its primary uses is in checking for 
the presence of the required number of arguments: 

if test $# -It 2 
then 

echo 'two or more args required'; exit 
fi 

$? Contains the exit status of the last command executed (also referred 
to as "return code", "exit code", or "value"). Its value is a decimal 
string. Most XENIX commands return zero to indicate successful 
completion. The shell itself returns the current value of $? as its exit 

status. 

$$ The process number of the current process. Because process 
numbers are unique among all existing processes, this string is often 
used to generate unique names for temporary files. XENIX provides 
no mechanism for the automatic creation and deletion of temporary 
files; a file exists until it is explicitly removed. Temporary files are 
generally undesirable objects; the XENIX pipe mechanism is far 
superior for many applications. However, the need for uniquely- 
named temporary files does occasionally occur. 

The following example illustrates the recommended practice of 
creating temporary files; note that the directories jutr and fuer/tmp 
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are cleared out if the system is rebooted. 

# use current process id 

# to form unique temp file 
teaip-«/usr/temp/$$ 

Is > $temp 

# commands here, some of which use Itemp 
rm $temp 

# clean up at end 

The process number of the last process run in the background (using 
the ampersand (&)). This is a string containing from one to five 
digits. 

A string consisting of names of execution flags currently turned on in 
the shell. For example, $- might have the value "xv" if you are 
tracingyour output. 



7.5 The Shell State 

The state of a given instance of the shell includes the values of positional 
parameters, user-defined variables, environment variables, modes of 
execution, and the current working directory. 

The state of a shell may be altered in various ways. These include changing the 
working directory with the cd command, setting several flags, and by reading 
commands from the special file, .profile , in your login directory. 



7.5.1 Changing Directories 

The cd command changes the- current directory to the one specified as its 
argument. This can and should be used to change to a convenient place in the 
directory structure. Note that cd is often placed within parentheses to cause a 
subshell to change to a different directory and execute some commands without 
affecting the original shell. ' „ 

For example, the first sequence below copies the file /ete/paeewd to 
I uerf you/ pae$wd; the second example first changes directory to /etc and then 
copies the file: 

cp /etc/passwd /usr/you/bin/passwd 
(cd /etc ; cp passwd /usr/you/passwd) 

Note the use of parentheses. Both command lines have the same effect. 
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7.5.2 The .profile File 

The file named .profile is read each time you log in to XENIX. It is normally used 
to execute special one-time-only commands and to set and export variables to 
all later shells. Only after commands are read and executed from .profile, does 
the shell read commands from the standard input — usually the terminal. 



7.5.3 Execution Flags 

The set command lets you alter the behavior of the shell by setting certain shell 
flags. In particular, the -x and -v flags may be useful when invoking the shell 
as a command from the terminal. The flags -x and-v may be set by typing: 

set -xv 
The same flags may be turned offby typing: 

set +xv 

These two flags have the following meaning: 

-v Input lines are printed as they are read by the shell. This flag is 
particularly useful for isolating syntax errors. The commands on 
each input line are executed after that input line is printed. 

-x Commands and their arguments are printed as they are executed. 
(Shell control commands, such as for, while, etc., are not printed, 
however.) Note that -x causes a trace of only those commands that 
are actually executed, whereas -v prints each line of input until a 
syntax error is detected. 

The set command is also used to set these and other flags within shell 
procedures. 

7.6 A Command's Environment 

All variables and their associated values that are known to a command at the 
beginning of its execution make up its environment. This environment 
includes variables that the command inherits from its parent process and 
variables specified as keyword parameter* on the command line that invokes 
the command. 

The variables that a shell passes to its child processes are those that have been 
named as arguments to the export command. The export command places 
the named variables in the environments of both the shell an (/all its future child 
processes. 
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Keyword parameters are variable- value pairs that appear in the ■form of 
assignments, normally before the procedure name on a command line. Such 
variables are placed in the environment of the procedure being invoked. For 
example: 

# keycommand 

echo $a $b 

This is a simple procedure that echoes the values of two variables. If it is 
invoked as: 

a=keyl b=key2 keycommand 

then the resulting output is: 

keyl key 2 

Keyword parameters are not counted as arguments to the procedure and do not 
affect$#. 

A procedure may access the value of any variable in its environment. However, 
if changes are made to the value of a variable, these changes are not reflected in 
the environment; they are local to the procedure in question. In order for these 
changes to be placed in the environment that the procedure passes to its child 
processes, the variable must be named as an argument to the export command 
within that procedure. To obtain a list of variables that have been made 
exportable from the current shell, type: 

export 

You will also get a list of variables that have been made readonly. To get a list 
of name-value pairs in the current environment, type either 

printenv 

or 



7.7 Invoking the Shell 

The shell is a command and may be invoked in the same way as any other 
command: 

sh proe [ arg .. . ] A new instance of the shell is explicitly invoked to 

read proe. Arguments, if any, can be 
manipulated. 
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sh-v proc [arg...] This is equivalent to putting "set -v" at the 

beginning of proc. It can be used in the same way 
for the -x, -e, -u , and -n flags. 

proc [ arg ... ] If proc is an executable file, and is not a compiled 

executable program, the effect is similar to that 
of: 

sh proc args 

An advantage of this form is that variables that 
have been exported in the shell will still be 
exported from proc when this form is used 
(because the shell only forks to read commands 
from proc). Thus any changes made within proc 
to the values of exported variables will be passed 
on to subsequent commands invoked from proc. 



7.8 Passing Arguments to Shell Procedures 

When a command line is scanned, any character sequence of the form $n is 
replaced by the nth argument to the shell, counting the name of the shell 
procedure itself as $0. This notation permits direct reference to the procedure 
name and to as many as nine positional parameters. Additional arguments can 
be processed using the shift command or by using a for loop. 

The shift command shifts arguments to the left; i.e., the value of $1 is thrown 
away, $2 replaces $1, $3 replaces $2, and so on. The highest-numbered 
positional parameter becomes uneet ($0 is never shifted). For example, in the 
shell procedure ripple below, echo writes its arguments to the standard output. 

# ripple command 

while test $# != 

do 

echo $1 $2 $3 $4 $5 $6 $7 $8 $9 

shift 
done 

Lines that begin with a number sign (#) are comments. The looping command, 
while, is discussed in Section 7.9.3 of this chapter. If the procedure were 
invoked with 

ripple a b c 

it would print: 
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a b c 

be 

c 



The special shell variable "star" ($*) causes substitution of all positional 
parameters except $0. Thus, the echo line in the ripple example above could be 
written more compactly as: 

echo $* 

These two echo commands are not equivalent: the first prints at most nine 
positional parameters; the second prints all of the current positional 
parameters. The shell star variable ($*) is more concise and less error-prone. 
One obvious application is in passing an arbitrary number of arguments to a 
command: For example 

wc $* 

counts the words of each of the files named on the command line. 

It is important to understand the sequence of actions used by the shell in 
scanning command lines and substituting arguments. The shell first reads 
input up to a newline or semicolon, and then parses that much of the input. 
Variables are replaced by their values and then command substitution (via 
back quotation marks) is attempted. I/O redirection arguments are detected, 
acted upon, and deleted from the command line. Next, the shell scans the 
resulting command line for internal field $eparator$, that is, for any characters 
specified by IFS to break the command line into distinct arguments; explicit 
null arguments (specified by"" or ") are retained, while implicit null 
arguments resulting from evaluation of variables that are null or not set are 
removed- Then filename generation occurs with all metacharacters being 
expanded. The resulting command line is then executed by the shell. 

Sometimes, command lines are built inside a shell procedure. In this case, it is 
sometimes useful to have the shell rescan the command line after all the initial 
substitutions and expansions have been performed. The special command eval 
is available for this purpose. Eval takes a command line as its argument and 
simply rescans the line, performing any variable or command substitutions 
that are specified. Consider the following (simplified) situation: 

command=who 
output== ' | wc -1' 
eval $command $output 

This segment of code results in the execution of the command line 

who J wc -1 

The output of eval cannot be redirected. However, uses of eval can be nested, 
so that a command line can be evaluated several times. 
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7.9 Controlling the Flow of Control 

The shell provides several commands that implement a variety of control 
structures useful in controlling the flow of control in shell procedures. Before 
describing these structures, a few terms need to be defined. 

A eimple eommandis any single irreducible command specified by the name of 
an executable file. I/O redirection arguments can appear in a simple command 
line and are passed to the shell, not to the command. 

A command is a simple command or any of the shell control commands 
described below. A pipeline is a sequence of one or more commands separated 
by vertical bars ( | ). In a pipeline, the standard output of each command but 
the last is connected (by a pipe) to the standard input of the next command. 
Each command in a pipeline is run separately; the shell waits for the last 
command to finish. The exit status of a pipeline is nonzero if the exit status of 
either the first or last process in the pipeline is nonzero. 

A command liet is a sequence of one or more pipelines separated by a semicolon 
(;), an ampersand (&), an "and- if symbol (&&), or an "or-if" ( || ) symbol, and 
optionally terminated by a semicolon or an ampersand. A semicolon causes 
sequential execution of the previous pipeline. This means that the shell waits 
for the pipeline to finish before reading the next pipeline. On the other hand, 
the ampersand (&) causes asynchronous background execution of the 
preceding pipeline. Thus, both sequential and background execution are 
allowed. A background pipeline continues execution until it terminates 
voluntarily, or until its processes are killed. 

Other uses of the ampersand include off-line printing, background 
compilation, and generation of jobs to be sent to other computers. For 
example, if you type 

nohup cc prog.c& 

you may continue working while the C compiler runs in the background. A 
command line ending with an ampersand is immune to interrupts or quits that 
you might generate by typing INTERRUPT or QUIT. It is also immune to 
logouts with CNTRL-D. However, CNTRL-D will abort the command if you are 
operating over a dial-up line. In this case, it is wise to make the command 
immune to hang-ups (i.e., logouts) as well. The nohup command is used for 
this purpose. In the above example without nohup, if you logout from a dial- 
up line while cc is still executing, cc will be killed and your output will 
disappear. 

The ampersand operator should be used with restraint, especially on heavily- 
loaded systems. Other users will not consider you a good citizen if you start up 
a large number of background processes without a compelling reason for doing 
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The and- if and or-if (&& and ||) operators cause conditional execution of 
pipelines. Both of these are of equal precedence when evaluating command 
lines (but both are lower than the ampersand (&.) and the vertical bar ( | )). In 
the command line 

cmdl || cmd2 

the first command, cmdl, is executed and its exit status examined. Only if 
cmdl fails (i.e., has a nonzero exit status) is cmrfi? executed. Thus, this is a more 
terse notation for: 

if cmdl 

test $? !— 
then 

cmd2 
fi 

The and-if operator (&.&.) operator yields a complementary test. For example, 
in the following command line 

cmdl &,&, cmd2 

the second command is executed only if the first succeeds (and has a zero exit 
status). In the sequence below, each command is executed in order until one 
fails: 

cmdl && cmd2 &.&. cmd3 &.&, ... && cmdn 

A simple command in a pipeline may be replaced by a command list enclosed in 
either parentheses or braces. The output of all the commands so enclosed is 
combined into one stream that becomes the input to the next command in the 
pipeline. The following line formats and prints two separate documents: 

{ nroff -mm textl; nroff -mm text2; } | Ipr 

Note that a space is needed after the left brace and that a semicolon should 
appear before the right brace. 



7.0.1 Using the if Statement 

The shell provides structured conditional capability with the if command. The 
simplest if command has the following form: 

if command-liet 
then command-liet 
fi 

The command list following the if isexecuted and if the last command in the list 
has a zero exit status, then the command list that follows then is executed. The 
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word fi indicates the end of the if command. 

To cause an alternative set of commands to be executed when there is a nonzero 
exit status, an else clause can be given with the following structure: 

if command-list 
then command-list 
else command-list 
fi 

Multiple tests can be achieved in an if command by using the elif clause, 
although the case statement (See Section 7.9.2) is better for large numbers of 
tests. For example: 



if 


test -f$r 








# 








is $1 a file? 


then 


pr $1 








elif 


test-d"$r 








# 








else, is $1 a directory? 


then 


(cd $1; pr *) 








else 


echo $1 is neither 


a file 


nor 


a directory 


fi 











The above example is executed as follows: if the value of the first positional 
parameter is a filename (-f), then print that file; if not, then check to see if it is 
the name of a directory (-d). If so, change to that directory (cd) and print all the 
files there (pr*). Otherwise, echo the error message. 

The if command may be nested (but be sure to end each one with a fi). The 
newlines in the above examples of if may be replaced by semicolons. 

The exit status of the if command is the exit status of the last command 
executed in any then clause or else clause. If no such command was executed, 
if returns a zero exit status. 

Note that an alternate notation for the test command uses brackets to enclose 
the expression being tested. For example, the previous example might have 
been written as follows: 

if | -fir] 

# is II a file? 
then pr ll 

elif [ -d "|1" ) 

# else, is ll a directory? 
then (cd ll; pr *) 

else echo ll is neither a file nor a directory 

fi 

Note that a space after the left bracket and one before the right bracket are 
essential in this form of the syntax. 
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7.0.2 Using the case Statement 

A multiple test conditional is provided by the case command. The basic 
format of the case statement is: 

case etring in 

pattern ) command-Hit ;; 

pattern ) command-liet ;; 
esac 

The shell tries to match string against each pattern in turn, using the same 
pattern-matching conventions as in filename generation. If a match is found, 
the command list following the matched pattern is executed; the double 
semicolon (;;) serves as a break out of the case and is required after each 
command list except the last. Note that only one pattern is ever matched, and 
that matches are attempted in order, so that if a star (*) is the first pattern in a 
case, no other patterns are looked at. 

More than one pattern may be associated with a given command list by 
specifying alternate patterns separated by vertical bars ( | ). 

case $i in 

*.c) cc $i 

*.h | *.sh) 

: do nothing 

>» 
*) echo "$i of unknown type" 



In the above example, no action is taken for the second set of patterns because 
the null, colon (:) command is specified. The star (*) is used as a default pattern, 
because it matches any word. 

The exit status of case is the exit status of the last command executed in the 
case command. If no commands are executed, then case has a zero exit status. 



7.0.3 Conditional Looping: while and until 

A while command has the general form: 

while command-liet 
do 

command-list 
done 
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The commands in the first command-list are executed, and if the exit status of 
the last command in that list is zero, then the commands in the second 
command-list are executed. This sequence is repeated as long as the exit status 
of the first command-liet is zero. A loop can be executed as long as the first 
command- list returns a nonzero exit status by replacing while with until. 

Any newline in the above example may be replaced by a semicolon. The exit 
status of a while (or until) command is the exit status of the last command 
executed in the second command-liet. If no such command is executed, while 
(or until) has a zero exit status. 



7.9.4 Looping Over a List: for 

Often, one wishes to perform some set of operations for each file in aset of files, 
or execute some command once for each of several arguments. The for 
command can be used to accomplish this. The for command has the format: 

for variable in word-list 
do 

command-list 
done 

Here word-list is a list of strings separated by blanks. The commands in the 
command-list 3.re executed once for each word in the word-list. Variable takes 
on as its value each word from the word list, in turn. The word list is fixed after 
it is evaluated the first time. For example, the following for loop causes each of 
the C source files xec.c, cmd.c, and word.c in the current directory to be 
compared with a file of the same name in the directory /usr/src/cmd/sh: 

for CFILE in xec cfnd word 

do diff${CFILE}.c/usr/src/cmd/sh/${CFILE}.c 

done 

Note that the first occurrence of CFILE immediately after the word for has no 
preceding dollar sign, since the name of the variable is wanted and not its value. 

You can omit the "in word-list''^ part of a for command; this causes the 
current set of positional parameters to be used in place of word-list. This is 
useful when writing a command that performs the same set of commands for 
each of an unknown number of arguments. Create a file named eckoS that 
contains the following shell script: 

for word 

do echo %word%word 

done 

Give echo 2 execute status: 
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chmod +x echo2 
Now type the following command: 

echo2 ma pa bo fi yo no so ta 

The output from this command is: 

mama 

papa 

bobo 

fifi 

yoyo 

nono 

soso 

tata 

7.0.5 Loop Control: break and continue 

The break command can be used to terminate execution of a while or a for 
loop. Continue requests the execution of the next iteration of the loop. These 
commands are effective only when they appear between do and done. 

The break command terminates execution of the smallest (i.e., innermost) 
enclosing loop, causing execution to resume after the nearest following 
unmatched done. Exit from n levels is obtained by break n. 

The continue command causes execution to resume at the nearest enclosing 
for, while, or until statement, i.e., the one that begins the innermost loop 
containing the continue. You can also specify an argument n to continue and 
execution will resume at the nth enclosing loop: 
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effect of using parentheses to group commands). 

2. Control commands" run slightly slower when redirected, because of 
the additional overhead of creating a shell for the control command. 



7.0.9 Transfer to Another File and Back: The Dot (.) Command 

A command line of the form 

. proc 

causes the shell to read commands from proc without spawning a new process. 
Changes made to variables in proc are in effect after the dot command finishes. 
This is a good way to gather a number of shell variable initializations into one 
file. A common use of this command is to reinitialize the top level shell by 
reading the .profile file with: 

. .profile 

7.9.10 Interrupt Handling: trap 

Shell procedures can use the trap command to disable a signal (cause it to be 
ignored), or redefine its action. The form of the trap command is: 

trap arg eignal-liet 

Here arg is a string to be interpreted as a command list and eignal-liet consists 
of one or more signal numbers as described in eignal(S)) in the XENIX Reference 
Manual. The most important of these signals follow: 



Number 


Signal 


00 
01 


KILL (CNTRL-U) 
HANGUP 


02 


INTERRUPT character 


03 
09 
11 
15 


QUIT 

KILL (cannot be caught or ignored) 

segmentation violation (cannot be caught or ignored) 

software termination signal 



The commands in arg are scanned at least once, when the shell first encounters 
the trap command. Because of thisj it is usually wise to use single rather than 
double quotation marks to surround these commands. The former inhibit 
immediate command and variable substitution. This becomes important, for 
instance, when one wishes to remove temporary files and the names of those 
files have not yet been determined when the trap command is first read by the 
shell. The following procedure will print the name of the current directory in 
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the file errdireet when it is interrupted, thus giving the user information as to 
how much of the job was done: 

trap echo *pwd s >errdirect'2 3 15 
for i in /bin /usr/bin /usr /gas/bin 
do 

cd$i 
# commands to be executed in directory $i here 
done 

Beware that the same procedure with double rather than single quotation 
marks does something different. The following prints the name of the directory 
from which the procedure was first executed: 

(trap "echo *pwd* > errdireet" 2 3 15) 

A signal 1 1 can never be trapped, because the shell itself needs to catch it to deal 
with memory allocation. Zero is interpreted by the trap command as a signal 
generated by exiting from a shell. This occurs either with an exit command, or 
by "falling through" to the end of a procedure. If arg is not specified, then the 
action taken upon receipt of any of the signals in the signal list is reset to the 
default system action. If arg is an explicit null string ( "or "" ), then the signals 
in the signal list are ignored by the shell. 

The trap command is most frequently used to make sure that temporary files 
are removed upon termination of a procedure. The preceding example would 
be written more typically as follows: 

temp=$HOME/temp/$$ 

trap 'rm $temp; trap 0; exit '012315 

Is > $temp 

# commands that use $temp here 

In this example, whenever signal 1 (hangup), 2 (interrupt), 3 (quit), or 15 (kill) is 
received by the shell procedure, or whenever the shell procedure is about to 
exit, the commands enclosed between the single quotation marks are executed. 
The exit command must be included, or else the shell continues reading 
commands where it left off when the signal was received. The "trap 0" in the 
above procedure turns off the original traps 1, 2, 3, and 15 on exits from the 
shell, so that the exit command does not reactivate the execution of the trap 
commands. 

Sometimes the shell continues reading commands after executing trap 
commands. The following procedure takes each directory in the current 
directory, changes to that directory, prompts with its name, and executes 
commands typed at the terminal until an end-of-file (CNTRL-D) or an interrupt 
is received. An end-of-file causes the read command to return a nonzero exit 
status, and thus the while loop terminates and the next directory cycle is 
initiated. An interrupt is ignored while executing the requested commands, but 
causes termination of the procedure when it is waiting for input: 
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d="pwcT 
for i in* 

do if test -d $d/$i 

then cd $d/$i 

while echo "$i:" 
trap exit 2 
read x 
do trap : 2 

# ignore interrupts 
eval $x 
done 
fi 
done 

Several traps may be in effect at the same time: if multiple signals are received 
simultaneously, they are serviced in numerically ascending order. To 
determine which traps are currently set, type: 

trap 

It is important to understand some things about the way in which the shell 
implements the trap command. When a signal (other than 11) is received by 
the shell, it is passed on to whatever child processes are currently executing. 
When these (synchronous) processes terminate, normally or abnormally, the 
shell polls any traps that happen to be set and executes the appropriate trap 
commands. This process is straightforward, except in the case of traps set at 
the command (outermost, or login) level. In this case, it is possible that no child 
process is running, so before the shell polls the traps, it waits for the 
termination of the first process spawned after the signal was received. 

When a signal is redefined in a shell script, this does not redefine the signal for 
programs invoked by that script; the signal is merely passed along. A disabled 
signal is not passed. 

For internal commands, the shell normally polls traps on completion of the 
command. An exception to this rule is made for the read command, for which 
traps are serviced immediately, so that read can be interrupted while waiting 
for input. 



7.10 Special Shell Commands 

There are several special commands that are inferno/ to the shell, some of which 
have already been mentioned. The shell does not fork to execute these 
commands, so no additionalprocesses are spawned. These commands should 
be used whenever possible, because they are, in general, faster and more 
efficient than other XENIX commands. The trade-off for this efficiency is that 
redirection of input and output is not allowed for most of these special 
commands. 
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Several of the special commands have already been described because they 
affect the flow of control. They are dot ( . ), break, continue, exit, and trap. 
The set command is also a special command. Descriptions of the remaining 
special commands are given here: 

: The null command. This command does nothing and 

can be used to insert comments in shell procedures. 
Its exit status is zero (true). Its utility as a comment 
character has largely been supplanted by the number 
sign (#) which can be used to insert comments to the 
end-of-line. Beware: any arguments to the null 
command are parsed for syntactic correctness; when 
in doubt, quote such arguments. Parameter 
substitution takes place, just as in other commands. 



cd arg 



exec arg. 



newgrp ar g. 



read var... 



Make arg the current directory. If arg is not a valid 
directory, or the user is not authorized to access it, a 
nonzero exit status is returned. Specifying cd with 
no arg is equivalent to typing "cd$HOME" which 
takes you to your home directory. 

If arg is a command, then the shell executes the 
command without forking and returning to the 
current shell. This effectively a "goto" and no new 
process is created. Input and output redirection 
arguments are allowed on the command line. If only 
input and output redirection arguments appear, 
then the input and output of the shell itself are 
modified accordingly. 

The newgrp command is executed, replacing the 
shell. Newgrp in turn creates a new shell. Beware: 
only environment yariables will be known in the shell 
created by the newgrp command. Any variables 
that were exported will no longer be marked as such. 

One line (up to a newline) is read from the standard 
input and the first word is assigned to the first 
variable, the second word to the second variable, and 
so on. All words left over are assigned to the la$t 
variable. The exit status of read is zero unless an 
end-of-file is read. 



readonly var. 



times 



The specified variables are made readonly so that 
no subsequent assignments may be made to them. If 
no arguments are given, a list of all readonly and of 
all exported variables is given. 

The accumulated user and system times for 
processes run from the current shell are printed. 
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umask nnn 



wait 



The user file creation mask is set to nnn. If nnn is 
omitted, then the current value of the mask is 
printed. This bit-mask is used to set the default 
permissions when creating files. For example, an 
octal umask of 137 corresponds to the following bit- 
mask and permission settings for a newly created file: 



User 


user 


group 


other 


Octal 


1 


3 


7 


bit- mask 


001 


Oil 


111 


permissions 


rw- 


T'- 


— 



See uma$k(G) in the XENIX Reference Manual for 
information on the value of nnn. 

The shell waits for all currently active child processes 
to terminate. The exit status of wait is always zero. 



7.11 Creation and Organization of Shell Procedures 

A shell procedure can be created in two simple steps. The first is building an 
ordinary text file. The second is changing the mode of the file to make it 
executable , thus permitting it to be invoked by 

proc args 

rather than 

sh proc args 

The second step may be omitted for a procedure to be used once or twice and 
then discarded, but is recommended for frequently-used ones. To set up a 
simple procedure, first create a file named maxlall with the following contents: 

LETTER=$1 

shift 

for i in $* 

do mail $i <$LETTER 

done 

Next type: 

chmod +x mail all 

The new command might then be invoked from within the current directory by 
typing: 
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mailall letter joe bob 

Here letter is the name of the file containing the message you want to send, and 
joe and bob are people you want to send the message to. Note that shell 
procedures must always be at least readable, so that the shell itself can read 
commands from the file. 

If mailall were thus created in a directory whose name appears in the user's 
PATH variable, the user could change working directories and still invoke the 
mailall command. 

Shell procedures may be created dynamically. A procedure may generate a file 
of commands, invoke another instance of the shell to execute that file, and then 
remove it. An alternate approach is that of using the <f of command (.) to make 
the current shell read commands from the new file, allowing use of existing shell 
variables and avoiding the spawning of an additional process for another shell. 

Many users prefer writing shell procedures to writing C programs. This is true 
for several reasons: 



1. A shell procedure is easy to create and maintain because it is only a file 
of ordinary text. 

2. A shell procedure has no corresponding object program that must be 
generated and maintained. 

3. A shell procedure is easy to create quickly, use a few times, and then 
remove. 

4. Because shell procedures are usually short in length, written in a 
high-level programming language, and kept only in their source- 
language form, they are generally easy to find, understand, and 
modify. 

By convention, directories that contain only commands and shell procedures 
are named bin. This name is derived from the word "binary", and is used 
because compiled and executable programs are often called "binaries" to 
distinguish them from program source files. Most groups of users sharing 
common interests have one or more bin directories set up to hold common 
procedures. Some users have their PATH variable list several such directories. 
Although you can have a number of such directories, it is unwise to go 
overboard: it may become difficult to keep track of your environment and 
efficiency may suffer. 



7.12 More About Execution Flags 

There are several execution flags available in the shell that can be useful in shell 
procedures: 
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-e This flag causes the shell to exit immediately if any command that it 
executes exits with a nonzero exit status. This flag is useful for shell 
procedures composed of simple command lines; it is not intended for 
use in conjunction with other conditional constructs. 

-u This flag causes unset variables to be considered errors when 
substituting variable values. This flag can be used to effect a global 
check on variables, rather than using conditional substitution to 
check each variable. 

-t This flag causes the shell to exit after reading and executing the 
commands on the remainder of the current input line. This flag is 
typically used by C programs which call the shell to execute a single 
command. 

-n This is a "don't execute" flag. On occasion, one may want to check a 
procedure for syntax errors, but not execute the commands in the 
procedure. Using "set -nv" at the beginning of a file will accomplish 
this. 

-k This flag causes all arguments of the form v art able= value to be 
treated as keyword parameters. When this flag is not set, only such 
arguments that appear before the command name are treated as 
keyword parameters. 



7.13 Supporting Commands and Features 

Shell procedures can make use of any XENIX command. The commands 
described in this section are either used especially frequently in shell 
procedures, or are explicitly designed for such use. 



7.13.1 Conditional Evaluation: test 

The test command evaluates the expression specified by its arguments and, if 
the expression is true, test returns a zero exit status. Otherwise, a nonzero 
(false) exit status is returned. Test also returns a nonzero exit status if it has no 
arguments. Often it is convenient to use the test command as the first 
command in the command list following an if or a while. Shell variables used 
in test expressions should be enclosed in double quotation marks if there is any 
chance of their being null or not set. 

The square brackets may be used as an alias to test, so that 

[ expression ] 

has the same effect as: 
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test expreeeion 

Note that the spaces before and after the expreeei on in brackets are essential. 

The following is a partial list of the options that can be used to construct a 
conditional expression: 

-r file True if the named file exists and is readable by the user. 

-w file True if the named file exists and is writable by the user. 

-x file True if the named file exists and is executable by the user. 

-sfile True if the named file exists and has a size greater than zero. 

-dfile True if the named file is a directory. 

-f file True if the named file is an ordinary file. 

-zel True if the length of string »X is zero. 

-nel True if the length of the string el is nonzero. 

-tfildee True if the open file whose file descriptor number is fildee is 

associated with a terminal device. If fildee is not specified, file 
descriptor 1 is used by default. 

si = e2 True if strings el and *2are identical. 

el != eS True if strings el and *2are not identical. 

el True if el is not the null string. 

nl -eq nS True if the integers nl and nSare algebraically equal; other 
algebraic comparisons are indicated by — ne (not equal), — gt 
(greater than), -ge (greater than or equal to), -It (less than ), 
and -le (less than or equal to). 

These may be combined with the following operators: 

! Unary negation operator. 

-a Binary logical AND operator. 

-o Binary logical OR operator; it has lower precedence than the 

logical AND operator (-a). 

{expr) Parentheses for grouping; they must be escaped to remove 

their significance to the shell. In the absence of parentheses, 
evaluation proceeds from left to right. 
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Note that all options, operators, filenames, etc. are separate arguments to test. 

7.13.2 Echoing Arguments 

The echo command has the following syntax: 

echo [optxont] [ arge] 

Echo copies its arguments to the standard output, each followed by a single 
space, except for the last argument, which is normally followed by a newline. 
Often, it is used to prompt the user for input, to issue diagnostics in shell 
procedures, or to add a few lines to an output stream in the middle of a pipeline. 
Another use is to verify the argument list generation process before issuing a 
command that does something drastic. The command 

Is 
is often replaced by 

echo * 

because the latter is faster and prints fewer lines of output. 

The -n option to echo removes the newline from the end of the echoed line. 
Thus, the following two commands prompt for input and then allow typing on 
the same line as the prompt: 

echo -n enter name:' 
read name 

The echo command also recognizes several escape sequences described in 
echo{C) in the XENIX Reference Manual. 

7.13.3 Expression Evaluation: expr 

The expr command provides arithmetic and logical operations on integers and 
some pattern-matching facilities on its arguments. It evaluates a single 
expression and writes the result on the standard output; expr can be used 
inside grave accents to set a variable. Some typical examples follow: 

# increment $A 
A=*expr $a + V 

# put third through last characters of 

# $1 into substring 
substring= v expr "$1" : '..\(.*\) ' * 

# obtain length of $1 
c= v expr "Si" : '.* ' \ 
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The most common uses of expr are in counting iterations of a loop and in using 
its pattern-matching capability to pick apart strings. 



7.13.4 True and False 

The true and false commands perform the functions of exiting with zero and 
nonzero exit status, respectively. The true and false commands are often used 
to implement unconditional loops. For example, you might type: 

while true 

do echo forever 
done 

This will echo "forever" on the screen until an INTERRUPT is typed. 



7.13.5 In-Line Input Documents 

Upon seeing a command line of the form 

command << eofetring 

where eofetring is any arbitrary string, the shell will take the subsequent lines 
as the standard input of command until a line is read consisting only of 
eofetring. (By appending a minus (-) to the input redirection symbol (<<), 
leading spaces and tabs are deleted from each line of the input document before 
the shell passes the line to command.) 

The shell creates a temporary file containing the input document and performs 
variable and command substitution on its contents before passing it to the 
command. Pattern matching on filenames is performed on the arguments of 
command lines in command substitutions. In order to prohibit all 
substitutions, you may quote any character of eofetring: 

command << \eofstring 

The in-line input document feature is especially useful for small amounts of 
input data, where it is more convenient to place the data in the shell procedure 
than to keep it in a separate file. For instance, you could type: 

cat < <- xx 

This message will be printed on the 
terminal with leading tabs and spaces 
removed. 



This in-line input document feature is most useful in shell procedures. Note 
that in-line input documents may not appear within grave accents. 
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7.13.6 Input/Output Redirection Using File Descriptors 

We mentioned above that a command occasionally directs output to some file 
associated with a file descriptor other than 1 or 2. In languages such as C, one 
can associate output with any file descriptor by using the tvrite(S) system call 
(see the XENIX Reference Manual. The shell provides its own mechanism for 
creating an output file associated with a particular file descriptor. By typing 

fdi>&fde 

where fdl and Jd2 are valid file descriptors, one can direct output that would 
normally be associated with file descriptor fdl to the file associated with JAB. 
The default value for fdl and fd2 is 1. If, at run time, no file is associated with 
fd2, then the redirection is void. The most common use of this mechanism is 
that of directing standard error output to the same file as standard output. 
This is accomplished by typing: 

command 2>&1 

If you wanted to redirect both standard output and standard error output to 
the same file, you would type: 

command l>file 2>&1 

The order here is significant: first, file descriptor 1 is associated with file ; then 
file descriptor 2 is associated with the same file as is currently associated with 
file descriptor 1. If the order of the redirections were reversed, standard error 
output would go to the terminal, and standard output would go to file, because 
at the time of the error output redirection, file descriptor 1 still would have 
been associated with the terminal. 

This mechanism can also be generalized to the redirection of standard input. 
You could type 

fda<&fdb 

to cause both file descriptors fda and fdb to be associated with the same input 
file. If fda or fdb is not specified, file descriptor is assumed. Such input 
redirection is useful for a command that uses two or more input sources. 



7;13.7 Conditional Substitution 

Normally, the shell replaces occurrences of ^variable by the string value 
assigned to variable, if any. However, there exists a special notation to allow 
conditional substitution, dependent upon whether the variable is set or not 
null. By definition, a variable is set if it has ever been assigned a value. The 
value of a variable can be the null string, which may be assigned to a variable in 
anyone of the following ways: 



7-37 



XENIX User's Guide 



A= 

bed—"" 
efg= " 
set " " 



The first three examples assign null to each of the corresponding shell variables. 
The last example sets the first and second positional parameters to null. The 
following conditional expressions depend-upon whether a variable is set and not 
null. Note that the meaning of braces in these expressions differs from their 
meaning when used in grouping shell commands. Parameter as used below 
refers to either a digit or a variable name. 



%{variable:-etring} 



${ vari able: = string} 



${variable:1 string} 



${ variable: + string} 



If variable is set and is nonnull, then substitute the 
value tvariable in place of this expression. 
Otherwise, replace the expression with string. Note 
that the value of variable is not changed by the 
evaluation of this expression. 

If variable is set and is nonnull, then substitute the 
value tvariable in place of this expression. 
Otherwise, set variable to string, and then 
substitute the value tvariable in place of this 
expression. Positional parameters may not be 
assigned values in this fashion. 

If variable is set and is nonnull, then substitute the 
value of variable for the expression. Otherwise, 
print a message of the form 

variable: string 

and exit from the current shell. (If the shell is the 
login shell, it is not exited.) If string is omitted in 
this form, then the message 

variable: parameter null or not set 

is printed instead. 

If variable is set and is nonnull, then substitute 
string for this expression. Otherwise, substitute the 
null string. Note that the value of variable is not 
altered by the evaluation of this expression. 



These expressions may also be used without the colon. In this variation, the 
shell does not check whether the variable is null or not; it only checks whether 
the variable has ever been set. 

The two examples below illustrate the use of this facility: 
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1. This example performs an explicit assignment to the PATH variable: 

"PATH"=${PATH:- ':/bin:/usr/bin -} 

This says, if PATH has ever been set and is not null, then keep its 
current value; otherwise, set it to the string ":/bin:/usr /bin". 

2. This example automatically assigns the HOME variable a value: 

cd ${HOME:= '/usr/gas '} 

If HOME is set, and is not null, then change directory to it. Otherwise 
set HOME to the given value and change directory to it. 

7.13.8 Invocation Flags 

There are four flags that may be specified on the command line when invoking 
the shell. These flags may not be turned on with the set command: 

-i If this flag is specified, or if the shell's input and output are both 
attached to a terminal, the shell is interactive. In such a shell, 
INTERRUPT (signal 2) is caught and ignored, and TERMINATE 
(signal 15) and QUIT (signal 3) are ignored. 

-s If this flag is specified or if no input/output redirection arguments 
are given, the shell reads commands from standard input. Shell 
output is written to file descriptor 2. The shell you get upon logging 
into the system has the -s flag turned on. 

-c When this flag is turned on, the shell reads commands from the first 
string following the flag. Remaining arguments are ignored. Double 
quotation marks should be used to enclose a multiword string, in 
order to allow for variable substitution. 

7.14 Effective and Efficient Shell Programming 

This section outlines strategies for writing efficient shell procedures, ones that 
do not waste resources in accomplishing their purposes. The primary reason 
for choosing a shell procedure to perform a specific function is to achieve a 
desired result at a minimum human cost. Emphasis should always be placed on 
simplicity, clarity, and readability, but efficiency can also be gained through 
awareness of a few design strategies. In many cases, an effective redesign of an 
existing procedure improves its efficiency by reducing its size, and often 
increases its comprehensibility. In any case, you should not worry about 
optimizing shell procedures unless they are intolerably slow or are known to 
consume an inordinate amount of a system's resources. 
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The same kind of iteration cycle should be applied to shell procedures as to 
other programs: write code, measure it, and optimize only the /etc important 
parts. The user should become familiar with the time command, which can be 
used to measure both entire procedures and parts thereof. Its use is strongly 
recommended; human intuition is notoriously unreliable when used to estimate 
timings of programs, even when the style of programming is a familiar one. 
Each timing test should be run several times, because the results are easily 
disturbed by variations in system load. 



7.14.1 Number of Processes Generated 

When large numbers of short commands are executed, the actual execution 
time of the commands may well be dominated by the overhead of creating 
processes. The procedures that incur significant amounts of such overhead are 
those that perform much looping and those that generate command sequences 
to be interpreted by another shell. 

If you are worried about efficiency, it is important to know which commands 
are currently built into the shell, and which are not. Here is the alphabetical list 
of those that are built in: 



break 


case 


cd 


continue 


eval 


exec 


exit 


export 


for 


if 


newgrp 


read 


readonly 


set 


shift 


test 


times 


trap 


umask 


until 


wait 


while 




: 


{} 



Parentheses, ( ), are built into the shell, but commands enclosed within them 
are executed as a child process, i.e., the shell does a fork, but no exec. Any 
command not in the above list requires both fork and exec. 

The user should always have at least a vague idea of the number of processes 
generated by a shell procedure. In the bulk of observed procedures, the number 
of processes created (not necessarily simultaneously) can be described by: 

processes = (k * n) + c 

where k and e are constants, and n may be the number of procedure arguments, 
the number of lines in some input file, the number of entries in some directory, 
or some other obvious quantity. Efficiency improvements are most commonly 
gained by reducing the value ol k, sometimes to zero. 

Any procedure whose complexity measure includes n' terms or higher powers 
of n is likely to be intolerably expensive. 

As an example, here is an analysis of a procedure named eplit, whose text is 
given below: 
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# split 

trap rm temp$$; trap 0; exit' 1 2 3 15 

startl=0 start2=0 

b*= lA-Za-z] ' 

cat > temp$$ 

# read stdin into temp file 

# save original lengths of $1, $2 
iftest-s"$r 

then startl= x wc -1 < $1* 

fi 

if test -s" $2" 

then start2= s wc -1 < $2 V 

fi 

grep "$b" temp$$ >> $1 

# lines with letters onto $1 
grep -v "$b" temp$$ | grep 10-9]' >> $2 

# lines with only numbers onto $2 
total=" v wc -1 < temp$$ x " 

endl= B wc-1 < IF" 

end2=" wc-1 < $2^" 

lost=" v expr $total - \($endl - $startl\) \ 

- \($end2 - $start2\) v " 

echo "$total read, $lost thrown away" 

For each iteration of the loop, there is one expr plus either an echo or another 
expr. One additional echo is executed at the end. If n is the number of lines of 
input, the number of processes is 2 * n + 1 . 

Some types of procedures should not be written using the shell. For example, if 
one or more processes are generated for each character in some file, it is a good 
indication that the procedure should be rewritten in C. Shell procedures should 
not be used to scan or build files a character at a time. 



7.14.2 Number of Data Bytes Accessed 

It is worthwhile considering any action that reduces the number of bytes read 
or written. This may be important for those procedures whose time is spent 
passing data around among a few processes, rather than in creating large 
numbers of short processes. Some filters shrink their output, others usually 
increase it. It always pays to put the ehrinkere first when the order is 
irrelevant. For instance, the second of the following examples is likely to be 
faster because the input to sort will be much smaller: 



sort file | grep pattern 
grep pattern file | sort 
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7.14.3 Shortening Directory Searches 

Directory searching can consume a great deal of time, especially in those 
applications that utilize deep directory structures and long pathnames. 
Judicious use of cd, the change directory command, can help shorten long 
pathnames and thus reduce the number of directory searches needed. As an 
exercise, try the following commands: 

Is -1 /usr/bin/* >/dev/null 
cd /usr/bin; Is -1 * >/dev/null 

The second command will run faster because of the fewer directory searches. 



7.14.4 Directory-Search Order and the PATH Variable 

The PATH variable is a convenient mechanism for allowing organization and 
sharing of procedures. However, it must be used in a sensible fashion, or the 
result may be a great increase in system overhead. 

The process of finding a command involves reading every directory included in 
every pathname that precedes the needed pathname in the current PATH 
variable. As an example, consider the effect of invoking nroff (i.e., 
juer/bin/nroff) when the value of PATH is ":/bin:/usr/bin". The sequence of 
directories read is: 



bin 

usr 
usr/bin 

This is a total of six directories. A long path list assigned to PATH can increase 
this number significantly. 

The vast majority of command executions are of commands found in /bin and, 
to a somewhat lesser extent, in /utr/bin. Careless PATH setup may lead to a 
great deal of unnecessary searching. The following four examples are ordered 
from worst to best with respect to the efficiency of command searches: 

/usr/john/bin:/usr/localbin:/bin:/usr/bin 
/bin:/usr/john/bin:/usr/localbin:/usr/bin 
/bin:/usr/bin:/usr/john/bin:/usr/localbin 
/bin::/usr/bin:/usr/john/bin:/usr/localbin 

The first one above should be avoided. The others are acceptable and the 
choice among them is dictated by the rate of change in the set of commands 
kept in /bin and /uer/bin. 
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A procedure that is expensive because it invokes many short-lived commands 
may often be speeded up by setting the PATH variable inside the procedure so 
that the fewest possible directories are searched in an optimum order. 



7.14.5 Good Ways to Set Up Directories 

It is wise to avoid directories that are larger than necessary. You should be 
aware of several special sizes. A directory that contains entries for up to 30 files 
(plus the required . and ..) fits in a single disk block and can be searched very 
efficiently, One that has up to 286 entries is still a small directory; anything 
larger is usually a disaster when used as a working directory. It is especially 
important to keep login directories small, preferably one block at most. Note 
that, as a rule, directories never shrink. This is very important to understand, 
because if your directory ever exceeds either the 30 or 286 thresholds, searches 
will be inefficient; furthermore, even if you delete files so that the number of 
files is less than either threshold, the system will still continue to treat the 
directory inefficiently. 



7.15 Shell Procedure Examples 

The power of the XENIX shell command language is most readily seen by 
examining how XENIX'S many labor-saving utilities can be combined to 
perform powerful and useful commands with very little programming effort. 
This section gives examples of procedures that do just that. By studying these 
examples, you will gain insight into the techniques and shortcuts that can be 
used in programming shell procedures (also called "scripts"). Note the use of 
the number sign (#) to introduce comments into shell procedures. 

It is intended that the following steps be carried out for each procedure: 



1. Place the procedure in a file with the indicated name. 

2. Give the file execute permission with the chmod command. 

3. Move the file to a directory in which commands are kept, such as your 
own 6»n directory. 

4. Make sure that the path of the 6in directory is specified in the PATH 
variable found in .profile. 

5. Execute the named command. 
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Is /bin /usr/bin | sort | uniq -d 

This procedure determines which files are in both /bin and /uer/bin. It is done 
because files in /bin will "override" those in /uer/bin during most searches and 
duplicates need to be weeded out. If the /uer/bin file is obsolete, then space is 
being wasted; if the /bin file is outdated by a corresponding entry in /uer/bin 
then the wrong version is being run and, again, space is being wasted. This is 
also a good demonstration of "sort | uniq" to find matches and duplications. 

COPYPAIRS 



# Usage: copypairs filel file2 ... 

# Copies filel to file2, file3 to file4, ... 
while test "$2" != "" 

do 

cp $1 $2 

shift; shift 
done 
if test "$1" !="" 

then echo "$0: odd number of arguments" 



This procedure illustrates the use of a while loop to process a list of positional 
parameters that are somehow related to one another. Here a while loop is 
much better than a for loop, because you can adjust the positional parameters 
with the shift command to handle related arguments. 
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# Usage: copyto dir file ... 

# Copies argument files to "dir", 

# making sure that at least 

# two arguments exist, that "dir" is a directory, 

# and that each additional argument 

# is a readable file, 
if test $# -It 2 

then echo "$0: usage: copyto directory file ..." 
elif test ! -d $1 

then echo "$0: $1 is not a directory"; 
else dir=$l; shift 

for eachfile 

do cp $eachfile $dir 

done 
fi 

This procedure uses an if command with several parts to screen out improper 
usage. The for loop at the end of the procedure loops over all of the arguments 
to copyto but the first; the original $1 is shifted off. 



DISTINCT! 



# Usage: distinctl 

# Reads standard input and reports list of 

# alphanumeric strings that differ only in case, 

# giving lowercase form of each, 
tr -cs 'A-Za-zO-9 ' '\012 1sort -u | \ 
tr 'A-Z ' 'a-z ' | sort | uniq -d 

This procedure is an example of the kind of process that is created by the left- 
to-right construction of a long pipeline. Note the use of the backslash at the end 
of the first line as the line continuation character. It may not be immediately 
obvious how this command works. You may wish to consult tr(G), $ort(C), and 
uniq(C) in the XENIX Reference Manual if you are completely unfamiliar with 
these commands. The tr command translates all characters except letters and 
digits into newline characters, and then squeezes out repeated newline 
characters. This leaves each string (in this case, any contiguous sequence of 
letters and digits) on a separate line. The sort command sorts the lines and 
emits only one line from any sequence of one or more repeated lines. The next 
tr converts everything to lowercase, so that identifiers differing only in case 
become identical. The output is sorted again to bring such duplicates together. 
The "uniq-d" prints (once) only those lines that occur more than once, yielding 
the desired list. 
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The process of building such a pipeline relies on the fact that pipes and files can 
usually be interchanged. The first line below is equivalent to the last two lines, 
assuming that sufficient disk space is available: 

cmdl | cmd2 | cmd3 

cmdl > tempi; < tempi cmd2 > temp2; < temp2 cmd3 
rm temp[123] 

Starting with a file of test data on the standard input and working from left to 
right, each command is executed taking its input from the previous file and 
putting its output in the next file. The final output is.then examined to make 
sure that it contains the expected result. The goal is to create a series of 
transformations that will convert the input to the desired output. 

Although pipelines can give a concise notation for complex processes, you 
should exercise some restraint, since such practice often yields 
incomprehensible code. 



DRAFT 



# Usage: draft file(s) 

# Print manual pages for Diablo printer, 
for i in $* 

do nroff -man $i | lpr 
done 

Users often write this kind of procedure for convenience in dealing with 
commands that require the use of distinct flags that cannot be given default 
values that are reasonable for all (or even most) users. 
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EDFIND 




# Usage: edfind file arg 

# Finds the last occurrence in "file" of a line 

# whose beginning matches "arg", then prints 

# 3 lines (the one before, the line itself, 

# and the one after) 

ed-$l <<-EOF 

?.$2? 


EOF 


-,+P 

q 



This illustrates the practice of using ed in-line input scripts into which the shell 
can substitute the values of variables. 



EDLAST 


# 
# 
# 
ed- 


Usage: edlast file 

Prints the last line of file, 

then deletes that line. 

-$i <<-V 

$p 
$d 




w 


l 


q 


echo done 



This procedure illustrates taking input from within the file itself up to the 
exclamation point ( ! ). Variable substitution is prohibited within the input text 
because of the backslash. 
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FSPLIT 



# Usage: fsplit filel file2 

# Reads standard input and divides it into 3 parts 

# by appending any line containing at least one letter 

# to filel, appending any line containing digits but 

# no letters to file2, and by throwing the rest away. 
count=0 gone=0 

while read next 
do 

count=" ''expr $count + 1 v " 
case "$next" in 
*[A-Za-z]*) 

echo "$next" >> $1 ;; 
*[0-9]*) 

echo "$next" >> $2 ;; 

•) 

gone="'expr $gone + V" 

esac 
done 
echo "$count lines read, $gone thrown away" 

Each iteration of the loop reads a line from the input and analyzes it. The loop 
terminates only when read encounters an end-of-file. Note the use of the expr 
command. 

Don't use the shell to read a line at a time unless you must — it can be an 
extremely slow process. 



7-48 



The Shell 
LISTFIELDS 

grep$* |tr":" "\012" 

This procedure lists lines containing any desired entry that is given to it as an 
argument. It places any field that begins with a colon on a newline. Thus, if 
given the following input 

joe newman: 13509 NE 78th St: Redmond, Wa 98062 

Uetfields will produce this: 

joe newman 
13509 NE 78th St 
Redmond, Wa 98062 

Note the use of the tr command to transpose colons to linefeeds. 
MKFILES 



# Usage: mkfiles pref [quantity] 

# Makes "quantity" files, named prefl, pref2, ... 

# Default is 5 as determined on following line. 
quantity=${2-5} 

i=l 

while test "$i" -le "Iquantity" 

do 

> $l$i 

i="'expr $i + T" 
done 

The mkfiles procedure uses output redirection to create zero-length files. The 
expr command is used for counting iterations of the while loop. 
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# Usage: null files 

# Create each of the named files as an empty file, 
for each file 

do 

>$eachfile 
done 

This procedure uses the fact that output redirection creates the (empty) output 
file if a file does not already exist. 



PHONE 



# Usage: phone initials ... 

# Prints the phone numbers of the 

# people with the given initials, 
echo 'inits ext home ' 
grep" A $r <<-END 

jfk 1234 999-2345 

lbj 2234 583-2245 

hst 3342 988-1010 

jqa 4567 555-1234 

END 

This procedure is an example of using an in-line input script to maintain a small 
database. 
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TEXTFILE 



if test" $1" — "-s" 

then 

# Return condition code 

shift 

if test -z " '$0 $* v " # check return value 

then 

exit 1 

else 

exitO 

fi 



if test $# -It 1 

then echo "$0: Usage: $0 [ -s ] file ..." 1>&2 

exitO 
fi 

file $* | fgrep ' text' | sed s/ : •*//' 



To determine which files in a directory contain only textual information, 
textfile filters argument lists to other commands. For example, the following 
command line will print all the text files in the current directory: 

pr ^textfile * v | Ipr 

This procedure also uses an -s flag which silently tests whether any of the Hies 
in the argument list is a text file. 



WRITEMAIL 



# Usage: writemail message user 

# If user is logged in, 

# writes message to terminal; 

# otherwise, mails it to user, 
echo "$1" | { write "$2" || mail "$2" ;} 

This procedure illustrates the use of command grouping. The message specified 
by $1 is piped to both the write command and, if write fails, to the mail 
command. 
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7.16 Shell Grammar 



item: 



word 

input- output 
name = value 



simple- command: item 

simple- command item 



command: 



pipeline: 



andor: 



command-list: 



simple -command 

( command-list ) 

{ command-list } 

for name do command-list done 

for name in word do command-list done 

while command-list do command-list done 

until command-list do command-list done 

case word in c ase-part esac 

if command-list then command-list else-part fi 

command 
pipeline \ command 

pipeline 

andor && pipeline 

andor || pipeline 

andor 

command-list ; 
command-list & 
command-list ; anrfor 
command-list & andor 



input- output: > /He 

<< word 
>> word* 

/He; wore/ 

&- 

case-part: pattern ) command-list ;; 

pattern: word 

pattern | toord 

else-part: elif command-list then command-list else-part 

else command-list 
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empty 

empty: 

word: a sequence of nonblank characters 

name: a sequence of letters, digits, or underscores 

starting with a letter 

digit: 0123456789 
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Metacharacters and Reserved Words 



a. Syntactic 




1 


Pipe symbol 


&& 


And- if symbol 


II 


Or- if symbol 


> 


Command separator 


55 


Case delimiter 


& 


Background commands 





Command grouping 


< 


Input redirection 


<< 


Input from a here document 


> 


Output creation 


< 


Output append 


# 


Comment to end of line 



b. Patterns 

* Match any character(s) including none 

? Match any single character 

[...] Match any of enclosed characters 

c. Substitution 

${...} Substitute shell variable 

\.. v Substitute command output 
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Quoting 

\ Quote next character as literal with no special meaning 

Quote enclosed characters excepting the back quotation 
marks ( *) 

" ..." Quote enclosed characters excepting: $ " \ " 



Reserved wor 


ds 




if 




esac 


then 




for 


else 




while 


elif 




until 


fi 




do 


case 




done 


in 




{ } 
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BC: A Calculator 

8.1 Introduction 

BC is a program that can be used as an arbitrary precision arithmetic 
calculator. BC's output is interpreted and executed by a collection of routines 
which can input, output, and do arithmetic on indefinitely large integers and on 
scaled fixed-point numbers. Although you can write substantial programs with 
BC, it is often used as an interactive tool for performing calculator-like 
computations. The language supports a complete set of control structures and 
functions that can be defined and saved for later execution. The syntax of BC 
has been deliberately selected to agree with the C language; those who are 
familiar with C will find few surprises. A small collection of library functions is 
also available, including sin, cos, arctan, log, exponential, andBessel functions 
of integer order. 

Common uses for BC are: 

— Computation with large integers. 

— Computations accurate to many decimal places. 

— Conversions of numbers from one base to another base. 

There is a scaling provision that permits the use of decimal point notation. 
Provision is made for input and output in bases other than decimal. Numbers 
can be converted from decimal to octal simply by setting the output base equal 
to8. 

The actual limit on the number of digits that can be handled depends on the 
amount of storage available on the machine, so manipulation of numbers with 
many hundreds of digits is possible. 

8.2 Demonstration 

This demonstration is designed to show you: 

— How to get into and out of BC. 

— How to perform simple computations. 

— How expressions are formed and evaluated. 

— How to assign values to registers. 

A normal session with BC begins by invoking the program with the command: 

be 
To exit BC type 
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quit 



or press CNTRL-D. Once you have entered BC, you can use it very much like a 
normal calculator. As with the XENIX shell, commands are read as command- 
lines, so each line that you type must be terminated by a RETURN. Throughout 
this chapter, the RETURN is implied at the end of each command line. Within 
BC, normal processing of other keys, such as BKSP and INTERRUPT, also 
works. 

For example, type the simple integer 5: 

5 

Output is immediately echoed on the next line to the standard output, which is 
normally the terminal screen: 

5 

Here "5" is a simple numeric expression. However, if you type the expression 

5*5.25 

(where the star (*) is the multiplication operator) a computation is executed 
and the result printed on the next line: 

26.25 

What has happened here is that the line "5*5.25" has been evaluated, i.e., the 
expression has been reduced to its most elementary form, which is the number 
26.25. The process of evaluation normally involves some type of computation 
such as multiplication, division, addition, or subtraction. For example, all four 
of these operations are involved in the following expression: 

(10*5)+50-(50/2) 

When this expression is evaluated, the subexpressions within parentheses are 
evaluated first, just as they would be with simple algebra, so that an 
intermediate step in the evaluation is "50+50-25" which ultimately reduces to 
the number "75". 

The simple addition 

10.45+5.5555555 
produces the output: 

16.0055555 
Note how precision is retained in the above result. 
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The two-part multiplication 

(8*9)*7 
produces the answer: 

504 

The last part of this demonstration shows you how to store values in special 
alphabetic registers. For example, type: 

a=100 ; b=5 

What happens here is that the registers "a" and "b" are assigned the values 100 
and 5, respectively. The semicolon is used here to place multiple BC statements 
on a single line, just as it is used in the XENIX shell. This command line 
produces no output because assignment statements are not considered 
expressions. However, the registers "a" and "b" can now be used in 
expressions. Thus you can now type 

a*b; a+b 

to produce: 

500 
105 

To exit BC, remember to type 

quit 

or press CNTRL-D. 

This ends the demonstration. Following sections describe use of BC in more 
detail. The final section of this chapter is aBC language reference. 

8.3 Tasks 

This section describes how to perform common BC tasks. Mastery of these 
tasks should turn you into a competent BC user. 

8.3.1 Computing with Integers 

The simplest kind of statement is an arithmetic expression on a line by itself. 
For instance, if you type 

142857 + 285714 
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and press RETURN, BC responds immediately with the line: 

428571 
Other operators also can be used. The complete list includes: 

■+-•■/%* 

They indicate addition, subtraction, multiplication, division, modulo 
(remaindering), and exponentiation, respectively. Division of integers 
produces an integer result truncated toward zero. Division by zero produces an 
error message. 

Any term in an expression can be prefixed with a minussign to indicate that it is 
to be negated (this is the "unary" minus sign). For example, the expression 

7+-3 

is interpreted to mean that -3 is to be added to 7. 

More complex expressions with several operators and with parentheses are 
interpreted just as in FORTRAN, with exponentiation (*) performed first, 
then multiplication (*), division (/), modulo (%), and finally, addition (+), and 
subtraction (-). The contents'of parentheses are evaluated before expressions 
outside the parentheses. All of the above operations are performed from left to 
right, except exponentiation, which is performed from right to left. Thus the 
following two expressions 

a A b A c and a'(b"c) 

are equivalent, as are the two expressions: 

a*b*c and (a*b)*c 

BC shares with FORTRAN and C the convention that a/b*c is equivalent to 
(a/b)*c. 

Internal storage registers to hold numbers have single lowercase letter names. 
The value of an expression can be assigned to a register in the usual way, thus 
the statement 

x = x + 3 

has the effect of increasing by 3 the value of the contents of the register named 
"x". When, as in this case, the outermost operator is the assignment operator 
(=), then the assignment is performed but the result is not printed. There are 
26 available named storage registers, one for each letter of the alphabet. 

There is also a built-in square root function whose result is truncated to an 
integer (See also Section 8.5, "Scaling"). For example, the lines 

8-4 



BC: A Calculator 



x = sqrt(191) 
x 

produce the printed result 

13 



8.3.2 Specifying Input and Output Bases 

There are special internal quantities in BC, called iba$e and obaee. Ibaee is 
initially set to 10, and determines the base used for interpreting numbers that 
are read by BG. For example, the lines 

ibase = 8 
11 

produce the output line 



and you are all set up to do octal to decimal conversions. However, beware of 
trying to change the input base back to decimal by typing: 

ibase = 10 

Because the number 10 is interpreted as octal, this statement has no effect. For 
those who deal in hexadecimal notation, the characters A-F are permitted in 
numbers (no matter what base is in effect) and are interpreted as digits having 
values 10-15, respectively. These characters muet be uppercase and not 
lowercase. The statement 

ibase = A 

changes you back to decimal input base no matter what the current input base 
is. Negative and large positive input bases are permitted; however no 
mechanism has been provided for the input of arbitrary numbers in bases less 
than 1 and greater than 16. 

Obaee is used as the base for output numbers. The value of obaee is initially set 
to a decimal 10. The lines 

obase = 16 
1000 

produce the output line: 

3E8 
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This is interpreted as a three-digit hexadecimal number. Very large output 
bases are permitted. For example, large numbers can be output in groups of 
five digits by setting obase to 100000. Even strange output bases, such as 
negative bases, and 1 and 0, are handled correctly. 

Very large numbers are split across lines with seventy characters per line. A 
split line that continues on the next line ends with a backslash (\). Decimal 
output conversion is fast, but output of very large numbers (i.e., more than 100 
digits) with other bases is rather slow. 

Remember that ibaee and obaee do not affect the course of internal 
computation or the evaluation of expressions; they only affect input and output 
conversion. 



8.3.3 Scaling Quantities 

A special internal quantity called $cale is used to determine the scale of 
calculated quantities. Numbers can have up to 99 decimal digits after the 
decimal point. This fractional part is retained in further computations. We 
refer to the number of digits after the decimal point of a number as its scale. 

When two scaled numbers are combined by means of one of the arithmetic 
operations, the result has a scale determined by the following rules: 

Addition, subtraction 

The scale of the result is the larger of the scales of the two 
operands. There is never any truncation of the result. 

Multiplication The scale of the result is never less than the maximum of the 
two scales of the operands, never more than the sum of the 
scales of the operands, and subject to those two restrictions, 
the scale of the result is set equal to the contents of the 
internal quantity, ecale. 

Division The scale of a quotient is the contents of the internal 

quantity, ecale. 

Modulo The scale of a remainder is the sum of the scales of the 

quotient and the divisor. 

Exponentiation The result of an exponentiation is scaled as if the implied 
multiplications were performed. An exponent must be an 
integer. 

Square Root The scale of a square root is set to the maximum of the scale 

of the argument and the contents of tcale. 

All of the internal operations are actually carried out in terms of integers, with 
digits being discarded when necessary. In every case where digits are discarded 
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truncation is performed without rounding. 

The contents of tcdt must be no greater than 69 and no less than 0. It is initially 
set to 0. 

The internal quantities ecale, ibaee, and baee can be used in expressions just 
like other variables. The line 

scale »■ scale + 1 
increases the value of $cale by one, and the line 

scale 

causes the current value of tcale to be printed. 

The value of eeale retains its meaning as a number of decimal digits to be 
retained in internal computation even when iba$e or obaec are not equal to 10. 
The internal computations (which are still conducted in decimal, regardless of 
the bases) are performed to the specified number of decimal digits, never 
hexadecimal or octal or any other kind of digits. 

8.3.4 Using Functions 

The name of a function is a single lowercase letter. Function names are 
permitted to use the same letters as simple variable names. Twenty-six 
different defined functions are permitted in addition to the twenty-six variable 
names. The line 

define a(x){ 

begins the definition of a function with one argument. This line must be 
followed by one or more statements, which make up the body of the function, 
ending with a right brace ( } ). Return of control from a function occurs when a 
return statement is executed or when the end of the function is reached. The 
return statement can take either of the two forms: 

return 
return(x) 

In the first case, the returned value of the function is 0; in the second, it is the 
value of the expression in parentheses. 

Variables used in functions can be declared as automatic by a statement of the 
form 

auto x,y,z 

There can be only one auto statement in a function and it must be the first 
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statement in the definition. These automatic variables are allocated space and 
initialized to zero on entry to the function and thrown away on return. The 
values of any variables with the same names outside the function are not 
disturbed. Functions can be called recursively and the automatic variables at 
each call level are protected. The parameters named in a function definition are 
treated in the same way as the automatic variables of that function, with the 
single exception that they are given a value on entry to the function. An 
example of a function definition follows: 

define a(x,y){ 
auto z 
z = x*y 

return(z) 

} 

The value of this function, when called, will be the product of its two 
arguments. 

A function is called by the appearance of its name, followed by a string of 
arguments enclosed in parentheses and separated by commas. The result is 
unpredictable if the wrong number of arguments is used. 

If the function "a" is defined as shown above, then the line 

a(7,3.14) 
would print the result: 

21.98 
Similarly, the line 

x - a(a(3,4),5) 

would cause the value of "x" to become 60. 

Functions can require no arguments, but still perform some useful operation or 
return a useful result. Such functions are defined and called using parentheses 
with nothing between them. For example: 

M) 

calls the function named b. 

8.3.5 Using Subscripted Variables 

A single lowercase letter variable name followed by an expression in brackets is 
called a subscripted variable and indicates an array element. The variable 
name is the name of the array and the expression in brackets is called the 
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subscript. Only one-dimensional arrays are permitted in BC. The names of 
arrays are permitted to collide with the names of simple variables and function 
names. Any fractional part of a subscript is discarded before use. Subscripts 
must be greater than or equal to zero and less than or equal to 2047. 

Subscripted variables can be freely used in expressions, in function calls and in 
return statements. 

An array name can be used as an argument to a function, as in: 

f(a[ ]) 

Array names can also be declared as automatic in a function definition with the 
use of empty brackets: 

define f(a[ ]) 
auto a[ ] 

When an array name is so used, the entire contents of the array are copied for 
the use of the function, then thrown away on exit from the function. Array 
names that refer to whole arrays cannot be used in any other context. 

8.3.6 Using Control Statements: if, while and for 

The if, while, and for statements are used to alter the flow within programs or 
to cause iteration. The range of each of these statements is a following 
statement or compound statement consisting of a collection of statements 
enclosed in braces. They are written as follows: 

if( relation) etatement 

while ( relation) $tatement 

tor(expreeeionl; relation; expree$ion2)etatement 

if (relation) {statement$} 

while ( relation) { $tatemente} 

for ( e xpr eett on 1; relation; expres$ion2) { etatemente} 

A relation in one of the control statements is an expression of the form 

expreesionl rel-op expreeeion2 
where the two expressions are related by one of the six relational operators: 

<><=>= =»— != 

Note that a double equal sign (==) stands for "equal to" and an exclamation- 
equal sign (!=) stands for "not equal to". The meaning of the remaining 
relational operators is their normal arithmetic and logical meaning. 
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Beware of using a single equal sign (=) instead of the double equal sign (==) in 
a relational. Both of these symbols are legal, so ycu will not get a diagnostic 
message. However, the operation will not perform the intended comparison. 

The if statement causes execution of its range if and only if the relation is true. 
Then control passes to the next statement in the sequence. 

The while statement causes repeated execution of its range as long as the 
relation is true. The relation is tested before each execution of its range and if 
the relation is false, control passes to the next statement beyond the range of 
the while statement. 

The for statement begins by executing expreeeionl. Then the relation is tested 
and, if true, the statements in the range of the for statement are executed. 
Then eipreesionSis executed. The relation is tested, and so on. The typical use 
of the for statement is for a controlled iteration, as in the statement 

for(i=l; i< = 10; i=i+l) i 

which will print the integers from 1 to 10. 

The following are some examples of the use of the control statements: 

define f(n){ 

auto i, x 

x=l 

for(i=l; i<=n; i=i+l) x=x*i 

return(x) 

} 

The line 

f(a) 

prints "a" factorial if "a" is a positive integer. 

The following is the definition of a function that computes values of the 
binomial coefficient ( "m" and "n" are assumed to be positive integers): 

define b(n,m){ 

auto x, j 



} 



x=l 

for(j=l; j<=m; j=j+l) x=x*(n-j+l)/j 
return(x) 
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The following function computes values of the exponential function by 
summing the appropriate series without regard to possible truncation errors: 

scale — 20 
define e(x){ 

auto a, b, c, d, n 

a= 1 

b = 1 

c«= 1 

d = 

n — 1 

while(l==l){ 

a = a*x 

b = b*n 

c = c + a/b 

n — n + 1 

if(c=— d) return(c) 

d = c 
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8.3.7 Using Other Language Features 

Some language features that every user should know about are listed below. 

— Normally, statements are typed one to a line. It is also permissible to 
type several statements on a line if they are separated by semicolons. 

— If an assignment statement is placed in parentheses, it then has a 
value and can be used anywhere that an expression can. For example, 
the line 

(*-y+l7) 

not only makes the indicated assignment, but also prints the resulting 
value. 

The following is an example of a use of the value of an assignment 
statement even when it is not placed in parentheses: 

x = a[i=i+l] 

This causes a value to be assigned to "x" and also increments "i" 
before it is used as a subscript. 

— The following constructions work in BC in exactly the same manner 
as they do in the C language: 



Construction 


Equivalent 


x=y=z 


x =fy=z) 


x =+ y 


x == x+y 


x =-y 


x = x-y 


x =* y 


x = x*y 


x =/y 


x = x/y 


x =%y 


x sss x%y 


x —* y 


x = x A y 


x++ 


(x=x+l)-l 


x — 


(x=x-l)+l 


+ + X 


X =x+l 


X 


X = x-1 



Even if you don't intend to use these constructions, if you type one 
inadvertently, something legal but unexpected may happen. Be 
aware that in some of these constructions spaces are significant. 
There is a real difference between "x=-y" and "x= -y". The first 
replaces "x" by "x-y" and the second by "-y". 
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The comment convention is identical to the C comment convention. 
Comments begin with "/*" and end with "*/". 

There is a library of math functions that can be obtained by typing 

bc-1 

when you invoke BC. This command loads the library functions sine, 
cosine, arctangent, natural logarithm, exponential, and Bessel 
functions of integer order. These are named "s", "c", "a", "1", "e", 
and "j(n,x)", respectively. This library sets $cde to 20 by default. 

If you type 

be file ... 

BC will read and execute the named file or files before accepting 
commands from the keyboard. In this way, you can load your own 
programs and function definitions. 
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8.4 Language Reference 

This section is a comprehensive reference to the BC language. It contains a 
more concise description of the features mentioned in earlier sections. 



8.4.1 Tokens 

Tokens are keywords, identifiers, constants, operators, and separators. Token 
separators can be blanks, tabs or comments. Newline characters or semicolons 
separate statements. 

Comments Comments are introduced by the characters "/*" and are 

terminated by"*/". 

Identifiers There are three kinds of identifiers: ordinary identifiers, 

array identifiers and function identifiers. All three types 
consist of single lowercase letters. Array identifiers are 
followed by square brackets, enclosing an optional expression 
describing a subscript. Arrays are singly dimensioned and 
can contain up to 2048 elements. Indexing begins at so an 
array can be indexed from to 2047. Subscripts are 
truncated to integers. Function identifiers are followed by 
parentheses, enclosing optional arguments. The three types 
of identifiers do not conflict; a program can have a variable 
named "x", an array named "x", and a function named "x", 
all of which are separate and distinct. 

Keywords The following are reserved keywords: 



ibase 


if 


obase 


break 


scale 


define 


sqrt 


auto 


length 


return 


while 


quit 


for 





Constants Constants are arbitrarily long numbers with an optional 

decimal point. The hexadecimal digits A-F are also 
recognized as digits with decimal values 10-15, respectively. 



8.4.2 Expressions 

All expressions can be evaluated to a value. The value of an expression is always 
printed unless the main operator is an assignment. The precedence of 
expressions (i.e., the order in which they are evaluated) is as follows: 
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Function calls 

Unary operators 

Multiplicative operators 

Additive operators 

Assignment operators 

Relation al oper ators 
There are several types of expressions: 

Named expressions 

Named expressions are places where values are stored. Simply stated, 
named expressions are legal on the left side of an assignment. The value 
of a named expression is the value stored in the place named. 

identifier* 

Simple identifiers are named expressions. They have an initial 
value of zero. 

array- n ante [expre eei on] 

Array elements are named expressions. They have an initial value 
of zero. 

$eale,ibaee and obate 

The internal registers tcalc, ibaee, and obate are all named 
expressions. Scale is the number of digits after the decimal point to 
be retained in arithmetic operations and has an initial value of zero. 
Iba$e and obate are the input and output number radixes 
respectively. Both ibate and obate have initial values of 10. 

Constants 

Constants are primitive expressions that evaluate to themselves. 

Parenthetic Expressions 

An expression surrounded by parentheses is a primitive expression. The 
parentheses are used to alter normal operator precedence. 

Function Calls 

Function calls are expressions that return values. They are discussed in 
section 8.10.3. 

8.4.3 Function Calls 

A function call consists of a function name followed by parentheses containing a 
comma-separated list of expressions, which are the function arguments. The 
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syntax is as follows: 

function-name ( [expre$eion ( , expreteion ... ] J ) 

A whole array passed as an argument is specified by the array name followed by 
empty square brackets. All function arguments are passed by value. As a 
result, changes made to the formal parameters have no effect on the actual 
arguments. If the function terminates by executing a return statement, the 
value of the function is the value of the expression in the parentheses of the 
return statement, or if no expression is provided or if there is no return 
statement. Three built-in functions are listed below: 

sqrt (expr) The result is the square root of the expression and is 

truncated in the least significant decimal place. The scale of 
the result is the scale of the expression or the value of $eale , 
whichever is larger. 

length( expr) The result is the total number of significant decimal digits in 
the expression. The scale of the result is zero. 

scale (expr) The result is the scale of the expression. The scale of the 
result is zero. 



8.4.4 Unary Operators 

The unary operators bind right to left. 

-expr The result is the negative of the expression. 

++named_expr The named expression is incremented by one. The result is 
the value of the named expression after incrementing. 

— named_expr The named expression is decremented by one. The result is 
the value of the named expression after decrementing. 

namei_expr++ The named expression is incremented by one. The result is 
the value of the named expression before incrementing. 

named_expr— The named expression is decremented by one. The result is 
the value of the named expression before decrementing. 

8.4.5 Multiplicative Operators 

The multiplicative operators (*, /, and %) bind from left to right. 

expr *expr The result is the product of the two expressions. If "a" and 

"b" are the scales of the two expressions, then the scale of the 
result is: 
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min ( a+b, max ( scale, a, b ) ) 

expr/expr The result fs the quotient of the two expressions. The scale of 

the result is the value of $cale . 

expr%expr The modulo operator (%) produces the remainder of the 

division of the two expressions. More precisely, a%b is 
a- a/6* 6. The scale of the result is the sum of the scale of the 
divisor and the value of tcalt. 

txpr* expr The exponentiation operator binds right to left. The result is 

the first expression raised to the power of the second 
expression. The second expression must be an integer. If "a" 
is the scale of the left expression and "b" is the absolute value 
of the right expression, then the scale of the result is: 

min ( a*b, max ( scale, a) ) 



8.4.6 Additive Operators 

The additive operators bind left to right 
cxpr+expr 



txpr-txpr 



The result is the sum of the two expressions. The scale of the 
result is the maximum of the scales of the expressions. 

The result is the difference of the two expressions. The scale 
of the result is the maximum of the scales of the expressions. 



8.4.7 Assignment Operators 

The assignment operators listed below assign values to the named expression 
on the left side. 

named_expr*=expr 

This expression results in assigning the value of the expression on 
the right to the named expression on the left. 

named_txpr—+txpr 

The result of this expression is equivalent to 
namci_jcxpr=namcd_cxpr+cxpr. 

named_jcxpr=-expr 

The result of this expression is equivalent to 
named_expr=named_cxpr-cxpr. 

named_expr=i*expr 

The result of this expression is equivalent to 
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named_expr=named_expr*expr. 

named_expr=f expr 

The result of this expression is equivalent to 
name d_expr=named_expr/ expr. 

named_expr*=%expr 

The result of this expression is equivalent to 
namedjtxpr=named_expr%expr. 

named_expr=* expr 

The result of this expression is equivalent to 
n ame d_jt xpr=* nam e djt xpr" expr. 



8.4.8 Relational Operators 

Unlike all other operators, the relational operators are only valid as the object 
of an if or while statement, or inside a for statement. These operators are 
listed below: 

expr< expr 

expr"> expr 

exprK =expr 

expr> =expr 

expr==expr 

expr!=expr 

8.4.0 Storage Classes 

There are only two storage classes in BC: global and automatic (local). Only 
identifiers that are to be local to a function need to be declared with the auto 
command. The arguments to a function are local to the function. All other 
identifiers are assumed to be global and available to all functions. 

All identifiers, global and local, have initial values of zero. Identifiers declared 
as auto are allocated on entry to the function and released on returning from 
the function. They, therefore, do not retain values between function calls. 
Note that auto arrays are specified by the array namer, followed by empty 
square brackets. 

Automatic variables in BC do not work the same way as in C. On entry to a 
function, the old values of the names that appear as parameters and as 
automatic variables are pushed onto a stack. Until return is made from the 
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function, reference to these names refers only to the new values. 

8.4.10 Statements 

Statements must be separated by a semicolon or a newline. Except where 
altered by control statements, execution is sequential. There are four types of 
statements: expression statements, compound statements, quoted string 
statements, and built-in statements. Each kind of statement is discussed 
below: 

Expression statements 

When a statement is an expression, unless the main operator 
is an assignment, the value of the expression is printed, 
followed by a newline character. 

Compound statements 

Statements can be grouped together and used when one 
statement is expected by surrounding them with curly braces 
({and}). 

Quoted string statements 
For example 

" etrinf 

prints the string inside the quotation marks. 

Built-in statements 

Built-in statements include auto, break, define, for, if, 
quit, return, and while. 

The syntax for each built-in statement is given below: 

Auto statement 

The auto statement causes the values of the identifiers to be 
pushed down. The identifiers can be ordinary identifiers or 
array identifiers. Array identifiers are specified by following 
the array name by empty square brackets. The auto 
statement must be the first statement in a function definition. 
Syntax of the auto statement is: 

auto identifier [, identifier] 

Break statement 

The break statement causes termination of a for or while 
statement. Syntax for the break statement is: 
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break 

Define statement 

The define statement defines a function; parameters to the 
function can be ordinary identifiers or array names. Array 
names must be followed by empty square brackets. The 
syntax of the define statement is: 

define ((parameter /, parameter ...JJ){etatements} 

For statement 

The for statement is the same as: 

first-expression 
while( relation) { 

'statement 
last-expression 

} 

All three expressions must be present. Syntax of the for 
statement is: 

for (expression; relation;expression) statement 

If statement 

The statement is executed if the relation is true. The syntax 
is as follows: 

if (relation) statement 

Quit statement 

The quit statement stops execution of a BC program and 
returns control to XENIX when it is first encountered. 
Because it is not treated as an executable statement, it cannot 
be used in a function definition or in an if, for, or while 
statement. Note that entering a CNTRL-D at the keyboard is 
the same as typing "quit". The syntax of the quit statement 
is as follows: 

quit 

Return statement 

The return statement terminates a function, pops its auto 
variables off the stack, and specifies the result of the function. 
The result of the function is the result of the expression in 
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parentheses. The first form is equivalent to "return(O)". The 
syntax of the return statement is as follows: 

return(expr) 

While statement 

The statement is executed while the relation is true. The test 
occurs before each execution of the statement. The syntax of 
the while statement is as follows: 

while (relation) etatement 
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Building a Uucp System 

9.1 Introduction 

The uucp system is a series of programs designed to permit communication between 
XENIX systems using dial-up communication lines. Uucp provides file transfer and 
remote command execution through a batch— type operation. Files are created in a 
spool directory forprocessing by the uucp daemons. There are three types of files used 
for the execution of work: 

Data files Contain data for transferto remote systems 

Workfiles Containdirectionsforfilctransfersbetweensystems 

Execution files Contain directions for XENIX command executions which 

involve the re sourcesof one or more systems. 

The uucp system consists of four primary and two secondary programs. The primary 
programs are: 

uucp This program creates work and gathers data files in the spool directory for 

the transmission of files. 

uux Thisprogram creates work files, execute filesandgathersdata files for the 

remote executionof XENIX commands. 

uucico Thisprogramexecutestheworkfilesfordatatransmission. 

uuxqt This program executes the execution files for XENIX command 

execution. 

The secondary programs are: 

uulog This program updates the log file with new entries and reports on the 

status of uucp requests. 

uuclean Thisprogramremovesokl files from the spool directory. 

This chapter describes the operation of each program, the installation of the system, 
the security aspects of the system, the files required for execution, and the 
administration of the system. 

For hardwired communications between XENIX systems, use the Micnet network 
described in the XENIX OperationsGuide . 

9.2 Uucp - System to System File Copy 

The uucp program is the user's primary interface with the system. The uucp program 
was designed to look like the cpcommand. The syntax is 

uucp [ option] ... source ... destination 

where source and destination may contain the prefix system— name! which indicates 
the sy stem on which the file or files re side or where they will be copied . 
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The options interpreted by uucp are: 

-d Makcdirectorieswhennecessaryforcopyingthefile. 

-c DonHcopy source filestothespooldnraoiY.butuscthcspedfiedsource 

whentheactualtransfertakesplace. 

-fetter Put letter in as the grade in the name ofthe work file. (This canbe used to 
change theorderofworkforapaiticular machine.) 

-m Sendmailoncompletionofthework. 

The foUowing options arcused primarily for debugging: 

-r Queuethejobbutdonotstartuucicoprogram. 

—tdir Usedirectory<tfrforthe spool directory. 

—xnum Useiwrnasthelevelofdebuggingoutput. 

The destination may be a directory name , in which case the file name is taken from the 
last part ofthe source's name. The source name may contain special shell characters 
such as "?*[]". If a source argument has a system- name! prefix for aremote system, 
the file name expansion will be doneonthe remote system. 

The command 

uucp *.c usgt/usr/dan 

will set up the transfer of all files whose names end with .cto\he/usr/dan directory on 
the usg machine. 

The source and/or destination names may also contain a iu«rprefix. This translates 
to the login directory on the specified system. For names with partial pathnames, the 
current directory is prepended to the file name. File names with "../" are not 
permitted. 

The command 

uucp usg!dan/*.h dan 

will set up the transfer of files whose names end with .h in dan's login directory on 
systemiMgtodan'slocdlogmdirectory. 

For each source file, the program will check the source and destination filenames and 
the system— part of each toclassify the work into one of five types: 

1. Copysourcetodestinationonlocalsystem. 

2. Receivefilesfromothersystems. 

3. Sendfilestoaremotesystems. 

4. Sendfilesfinomremotesystemstoanotherrenwtesystem. 

5. Receive files from remote systems when the source contains special shell 
characters asmentioned above . 
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Aftertheworkhasbeensetupui the spool directory, the w/ic/co program is started totry 
to contact the othermachine tocxecute the work (unless the — r option was specified). 

9. 2. 1 Copying Files to a Local Destination 

A cp command is used to do type 1 work. The— dandthe— moptionsare not honored 
in this case. 

9.2.2 Receiving Files from Other Systems 

For type 2 work, a one line work file is created for each tile requested and put in the 
spool directory with the following fields, each separated by a blank. 

fil R 

[2] The full pathname of the source or a user/pathname. The user part 

will be expanded on the remote system. 

[3| The full pathname ofthe destination file. If the user notation is used, it 

will be immediate ly expanded to be the login directory for the user. 

[4] Theuser'sloginname. 

[5] A "— " followed by an option list. (Onry the — m and — d options will 

appear in this list.) 

9.2.3 Sending Files to Remote Systems 

For type 3 work, a work file is created for each dsource file and the source file is copied 
into a data file in the spool directory. (A — c option on the uucp program will prevent 
the data file from being made, in this case, the file will be transmitted from the 
indicated source. ) The fields of each entry are givenbelow. 

fll s 

[2] The full pathname ofthe source file. 

[3| Thefullpathnameofthedestinationor user/filename. 

f4| Theuser'sloginname. 

[5] A"-"foIlowedbyanoptionlist. 

[6| Thenameofthedatafileinthespooldirectory. 

[7] Thefilemodebitsofthesourcefileinoctalprintformat(e.g. 0666). 
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9.2.4 Copying Ffles Between Systems 

For tyj>e 4 and 5 work, uucp generates a uucp command line and sends it to the remote 
machine; the remoteuue/coexecutesthe command line. 

9.3 Uux - System To System Execution 

The uux command is used to set up the execution of a XENIX command where the 
execution machine and/or some of the files are remote. The syntax of the uux 
command is 

uux [ — ] f option J ... command— string 

where command— string is made up of one or more arguments. All special shell 
characters such as "<>!*" must be quoted either by quoting the entire command 
string or quoting the character asa separate argument. Within the command string, the 
command and file names may contain a system— name! prefix. All arguments which 
do not contain a "!" will not be treated as files. (They will not be copied to the 
execution machine.) The - option is used to indicate that the standard input for the 
given command should be inherited from the standard input of the mux command. The 
options, essentially for debugging, are: 

— r DonotstartuKcicooruiaf/afterqueuingthejob 

—xnum Use/iumasthelevelofdebuggingoutput. 

The command 

pr abc I uux — usgllpr 

will set up the output of " pr abc '* as standard input to an Ipr command to be executed on 
system usg. 

Dux generates an execute file which contains the names of the files required for 
execution (including standard input), the user's login name, the destination of the 
standard output, and the command to be executed. This file is either put in the spool 
directory for local execution or sent to the remote system using a generated send 
command (type3 above). 

For required files which are not on the execution machine, uux will generate receive 
command files (type 2 above). These command- files will be put on the execution 
machine and executed by the uucico program. (This will work only if the local system 
has permission to put files in the remote spool directory as controlled by the remote 
USERFILE.) 

The execute file will be processed by the uuxqt program on the execuiionmachine . It is 
made up of several lines, each of which contains an identification character and one or 
more arguments. The order of the lines in the file is not relevant and some of the lines 
may not be present. Each line is described below. 

User Line 

U user system 

where the i*£ir and system are therequester'slogin name and system. 
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Required File Line 

F filename real— name 

where the filename is the generated name of a file for the execute machine and real- 
name is the last part of the actual tile name (contains no path information). Zero or 
more of these lines may be present intheexecutefile. The uuxqt program will check for 
the existence of allrequired files before the command is executed. 

Standard Input Line 

1 filename 

The standard input is either specified by a *'<" in the command —string or inherited 
from the standard input of the uux command if the — option is used. If a standard input 
is not specified, Idevlnull is used. 

Standard Output Line 

O filename system— name 

The standard output is specified by a ' ' > " within the command — string. If a standard 
output is not specified, Idevlnull is used. (Note that the use of ">>" is not 
implemented.) 

Command Line 

C command [ arguments | ... 

The arguments are those specified in the command string. The standard input and 
standard output will not appear on this line. All required files will be moved to the 
execution directory (a subdirectory of the spool directory) and the XENIX command is 
executed using the Shell specified in the uucp. h header file. In addition, a shell PATH 
statement is prepended to the command line as specified in the uuxqt program . 

After execution, the standard output is copied or set up tobescnttothe proper place. 
9.4 Uucico - Copy In, Copy Out 

The uwc/co program will perform the followingmajor functions: 

— Scanthe spool directory for work. 

— Place a call to a remote system. 

— Negotiate a line protocol to be used. 

— Execute all requests from both systems. 

— Log work requests and work completions. 

Uucico may be started by a system daemon, by one of the uucp , uux , uuxqt , or uucico 
programs, by the user (this is usually for testing), or by a remote system. (The uucico 
program should be specified as the shell field in the letclpasswd file for the uucp 
logins.) 

When started by method a daemon, a program, or the user, the program is considered 
to be in MASTER mode. In this mode, a connection will be made to a remote system. If 
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started by a remote system „ the program is considered to be in SLA VE mode . 

The MASTER mode will operate in one of two ways. If no system name is specified (the 
-soptionnotspecined)theprogramwillscanthespooldirectoryforsystcmstocall. If 
a system name is specified, that system will be called, and work will only be done for 
that system. 

The uucico program is generally started by another program. There are se veraloptions 
used for execution: 

— rl Sun the program in MASTER mode. This is used when uucico is started 

by a program or cron shell. 

— ssys Do work only for system sys . If — s is specified, a call to the specified 

system will be made even if there is no work for system sys in the spool 
directory. This is useful for polling systems which do not have the 
hardware to initiate a connection. 

The following operions are used primarily for debugging: 

—ddir Use directory J/r for the spool directory. 

— mum Use/uwi as the levelof debugging output. 

The next part of this section will describe the major steps within the uuc/co program. 

9.4.1 Scanning For Work 

The names of the work related files in the spool directory have format 

type . system— name grade number 

where type may be "C" for copy command file, "D" for data file, "X" for execute 
file, system— name is the remote system, grade is a character, and number is a four 
digit, padded sequence number. 

The file 

C.res45n0031 

is a work file for a file transfer between the local machine and the res45 machine. 

The scan for work is done by looking through the spool directory for work files (files 
with prefix C. ). A list is made of all systems to be called. Uucico will then call each 
system and process all work files. 

9.4.2 Calling a Remote System 

The call is made using information from several files which reside in the uucp program 
directory. At the start of the call process, a lock is set to forbid multiple conversations 
between the same two systems. 

The system name is found in the L. sys file . The information contained for each system 
is; 
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j 1 1 System name 

|2| Timcstocallihe system (days -of -week and times— of— day) 

[3| Deviceordevicetypetobeusedforcall 

[4] line speed 

f 5] phone number if field [3] is ' ' ACU " or the device name (same as field [3]) 

if not 

[6] Login information (multiple fields) 

The time field is checked against the present time to see if the call should be made . 

The phone number may contain abbreviations (e.g. mh, py, boston) which get 
translated intodial sequencesusingtheL— diatcodes file. 

The L— devices file is scanned using device type and line speed fields from the L.sys&k 
to find an available device for the call. The program will try all devices which satisfy 
these fields until the call is made, or no more devices can be tried. If a device is 
successfully opened, a lock file is created so that another copy oiuueico will not try to 
use it. If the call is complete, the login information n the last field of L.sys is used to 
login. 

The conversation between the two uucico programs begins with a handshake started 
by the SLAVE system. The SLAVE sends a message to let the MASTER know it is ready 
to receive the system identification and conversation sequence number. The response 
from the MASTER is verified by the SLAVE and if acceptable, protocol selection 
begins. The SLAVE can also reply with a call— back required message in which case, 
the current conversat ion is terminated . 

9.4.3 Selecting Line Protocol 

The remote system sends a message 

Pproto—tist 

where prow— list is a string of characters, each representing a line protocol. 

The calling program checks the protocol list for a letter corresponding to an available 
line protocol and returns a use protocol message . The message has the form 

Vcode 

where code is either a one character protocol letter or "N" which means there is no 
commonprotocol. 

9.4.4 Processing Work 

The initial role of MASTER or SLA VE for the work processing is the mode in which each 
program starts. (The MASTER has been specified by the — rl option.) The MASTER 
program does a work search similar to the one used in the section "Scanning For 
Work" above. 



9-7 



XENIX User's Guide 



There are five messages used during the work processing, each specified by the first 
character of the message. They are; 



s 


Send a file 


R 


Receive a file 


C 


Copy complete 



X Execute a uucp command 

H Hangup 

The MASTER will send R , S, or X messages until all work from the spool directory is 
complete, at which point an // message is sent. The SLAVE will reply with the first 
letter of the reque st and either the letter " Y " or "N " for yes or no. For example , the 
message " S Y " indicates that it is okay to send a file. 

The send and receive replies are based on permission to access the requested 
file/ directory using the USERFILE and read/write permissions of the file/directory. 
After each file is copied into the spool directory of the receiving system, a copy- 
complete message is sent by the receiver of the file. The message "CY" will be sent if 
the file has successfully been moved from the temporary spool file to the actual 
destination. Otherwise, a "CN" message is sent. (In the case of "CN", the 
transferred file will be in the spool directory with a name beginning with * 'TM ' . ) The 
requests and results are logged on both systems. 

The hangup response is determined by the SLAVE program by a work scan of the spool 
directory. If work for the remote system exists in the SLAVE'S spool directory, an 
"HN" message is sent and the programs switch roles. If no work exists, an "H Y" 
response is sent. 

9.4.5 Terminating a Conversation 

When a ' *H Y " message is received by the MASTER it is echoed back to the SLAVE and 
the protocols are turned off: Each program sends a final ' 'OO' ' message to the other. 
The original SLAVE program will clean up and terminate. The MASTER will proceed 
to call other systems and process work as long as possible or terminate if a — s option 
was specified. 

9.5 Uuxqt - Uucp Command Execution 

The uuxqt program is used to process execute files generated by uux. The uuxqt 
program may be started by either the uucico or uux programs. The program scans the 
spool directory for execute files (prefix X. ). Each one is checked to see if all the 
required files are available and if so, the command line or send line isexecuted. 

The execute file is described in the section ' 'Uux — System to System Copy " above. 

The execution is accomplished by executingthe shellcommand 

sh — c 

with the command line after appropriate standard input and standard output have been 
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opened, it a standard output is specified, the program will create a send command or 
copy the output tile as appropriate. 

9.6 Uulog — Uucp Log Inquiry 

The uucp programs create individual log files for each program invocation. 
Periodically, uulog may be executed to append these files to the system logfile. This 
method of logging was chosen to minimize file locking of the logfile during program 
execution. 

The uulog program merges the individual log files and outputs specified log entries. 
The output request is specified by the use of the following options: 

— s.vy s Print entries where sys is the remote system name 

— uuser PrintentriesforuseriMer. 

The intersection of lines satisfying the two options is output. A null sys or user means 
allsystemnamesorusersrespectively. 

9.7 Uuclean - Uucp Spool Directory Cleanup 

This program is typically started by the daemon, once a day. Its function is to remove 
files from the spool directory which are more than three days old. These are usually 
files for work which can not be completed. 

The options available are: 

— dtiir ThedirectorytobescannedisJ/r. 

— m Send mail to the owner of each file being removed . (Note that most files 

put into the spool directory will be owned by the owner of the uucp 
programs since the setuid bit will be set on these programs. The mail will 
therefore most often go to the owner of the uucp programs . ) 

—nhours Change theagingtime from 72hourstoAou/-5 hours. 

—Vpre Examine files with prefixpre for deletion. (Up to 10 file prefixes may be 
specified.) 

- xnum U se man asthe level of debugging output desired. 

9.8 Security 

The uucp system, left unrestricted, will let any outside user execute any commands 
and copy in/out any file which is readable/writable by the uucp login user. It is uptothe 
individual sites to be aware of this and apply the protections that they feel are 
necessary. 

There are several security features available aside from the normal file mode 
protections. These must be set up by the installer of the uucp system. 
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The login for uucp doe s not get a standard shell . Instead , the uucico program is started . 
Therefore , the only work that can be done is through uucico . 

A path check is done on file names that are to be sent or received. The USERFILE 
supplies the information for these checks. The USERFILE can also be set up to require 
call— back for certain login— ids. See the section "Required Files" below in this 
chapter. 

A conversation sequence count can be set up so that the called system can be more 
confident that the caller is who he say she is. 

The uuxqt program comes with a list of commands that it will execute. A PATH shell 
statement is prepended to the command line as specified in the uuxqt program. The 
installer may modify the list or remove the restrictions as desired. 

The L.sys file should be owned by uucp and have mode 0400 to protect the phone 
numbers and login information for remote sites. (The uucp , uucico , uux , and uuxqt 
should be also owned by uucp and have the setuidbit set.) 

9.9 Installing a Uucp System 

The uucp system provided with the XENIX Software Development System is already 
configured for operation on your computer. To install the system, you must edit a few 
files to provide information about your local site. The following sections provide an 
overview ofthe files to be edited and the information required. 

During execution ofthe uucp programs, the uucp system uses files from the following 
three directories: 

program (lusrllibluucp) This is the directory used for the executable system 

programs and the system files. 

spool (lusrlspoolluucp) This is the spool directory used during uucp 

execution. 

xqtdir (/usr/spool/uucp/.XQTDIR)Tbisf\ircciory isused duringexecutionof 

execute files. 

The names given in parentheses above are the default values for the directories. The 
names lib , program , xqtdir , and spool will be used in the following text to represent 
the appropriate directory names. 

9.9.1 Modifying the /etc/ systemid File 

You must choose a unique site name for each computer to be directly connected to a 
uucp line and add the site name to the letc/systemid file ofthe corresponding computer 
by using a XENIX text editor . The /etc/systemid&h can actually contain two names: the 
uucp site name, which must appear on the first line ofthe file, and a Micnet machine 
name, which must appear on the next line. However, you may decide to have both the 
uucp site name and Micnet machine name to be the same, in which case, only one name 
is required. For a description of the file, see systemid(M) in the XENIX Reference 
Manual. 
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9.9.2 Creating the Required Files 



There are four Qles which are required for execution, all of which should reside in the 
program directory . To prepare the uucp system for execution, you must add your own 
site specific information to these files by editing the files with a XENIX text editor. The 
field separatorfor all files is a space unless otherwise specified. 

L— devices 

This file contains entries for the call— unit devices and hardwired connections which 
are to be used by uucp . The special device files are assumed to be in the Idev directory . 
The format for each entry is 

line call— unit speed 

where line is the device for the line (e.g. culO), call— unit is the automatic call unit 
associat ed with line (e.g. cuaO), Hard wired lineshave a number "0" in this field, and 
.$/««/ is the line speed. 

The line 

culO cuaO 300 

defines a system which has device ' 'culO' * wired to a call —unit ' 'cuaO' ' for use at 300 
baud. 

L-dialcodes 

This file contains entries with location abbreviations used in the L.sys file (e.g. py , mh, 
boston). Theentry format is 

abb dial— seq 

where abb is the abbreviation, and dial— seq is the dial sequence to call that location. 
The line 

py 165- 

cau ses the entry py 7777 to be expanded to 1 65 —7777. 

USERFILE 

Thisfilecontainsuseraccessibility information. It specifies 

— Thefilesthatcanbeaccessedbyanormaluserofthelocalmachine 

— Thefilesthatcanbeaccessedfromaremotecomputer 

— The login nameused by a particular remote computer 

— Whether a remote computer should be called back in order to confirm its 
identity 

Each line in the file has the following format 

login,sys f c | pathname f pathname j ... 

where login is the login name for a user or the remote computer, sys is the system name 
for a remote computer, c is the optional call— back required flag, and pathname is a 
pathname prefix that isacceptableforitfir. 
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It is assumed that the login name used by a remote computer to call into a local 
computer is not the same as the login name of a normal user of that local machine. 
However, several remote computers may employ the same login name. 

Each computer is given a unique system name which is transmitted at the start of each 
call. Thisnameidentiuesthecallingmachinetothecalledmachine. 

When the program is obeying a command stored on the local machine, MASTER 
mode, the pathnames allowed are those given for the first line in the USERFILElhalhas 
a login name that matches the login name of the user who entered the command. If no 
such line is found, the first line with a nw//loginname is used. 

When the program is responding to a command from a remote machine, SLAVE mode, 
the pathnames allowed are those given for the first line in the file that has the system 
name that matches the system name ofthe remote machine. If no such line is found, the 
first one with a null system name is used . 

When a remote computer logs in, the login name that it uses must appear in the 
USERF1LE. There may be several lines with the same login name but one of them 
must either have the name ofthe remote system or must contain a null system name . 

If a line is found that has the appropriate login and remote system names and also 
contains a "c'\ the remotemachine is called back before any transactions takeplace. 

The line 

u,m /usr/xyz 

allows machine ' *m' * to login with name "u" and request the transfer of files whose 
names start with ' Vusr/xyz* ' . " 

The line 

dan, /usr/dan 

allows the ordinary user "dan" to issue commands for files whose name starts with 
"/usr/dan". 

The lines 

u,m /usr/xyz /usr/spool 
u, /usr/spool 

allow any remote machine to login with name ' 'u " , but if its system name is not "m" , 
it can only ask to transfer files whose names start with ' Vusr/spool' * . 

The lines 

root, / 
, /usr 

allow any user to transfer files beginning with ' '/usr' ' but the user with login ' 'root" 
cantransfer any file . 

L.sys 

Each entry in this file represents one system which can be called by the local uucp 
programs. The fields are described below. 

system name The name of the remote system. 
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tune This is a siring which indicates the days— of— week and times— of— day 

when the system should be called (e. g. MoTuThOSOO- 1 730). The day 
portion may be a list containing some of 

Su Mo Tu We Th Fr Sa 

or it may be * ' \Vk' * for any week— day or ' 'Any' ' for any day. The time 
should be a range of times (e.g. 0800—1230). If no time portion is 
specified, any time of day is assumed to be ok for the call. 

device Thisiseithcr < 'ACU"orthehardwireddevicctobeusedforthecall. For 

the hardwired case, the last part of the special file name isused (c. g. ttyO). 

speed Thisisthelinespeedforthecall(e.g. 300). 

phone The phone number is made up of an optional alphabetic abbreviation and 

a numeric part. The abbreviation is one which appears in the L— 
dialcodes file (e.g. mh5900, boslon995-9980). For the hardwired 
devices, this field contains the same string asused forthe device field. 

login The login information is given as a series of fields and subfields in the 

format 

expect send f expect send ] ... 

where expect is the string expected to be read and send is the string to be 
sent when the expected string is received. The expect field may be made 
up of subfields of the form 

expect f —send—expectl | ... 

where send is sent if the prior expect is not successfully read and expect 1 
is the next expected string . 

There are two special names available to be sent during the login 
sequence. The string "EOT" sends an EOT character and the string 
"BREAK* ' tries to send a BREAK character. (The BREAK character is 
simulated using line speed changes and null characters and may not work 
on all devices and/or systems . ) 

Atypical entry in the L. sys file is 

sys Any ACU 300 mh7654 login uucp ssword: word 

The expect algorithm looks at the last part of the string as illustrated in the password 
field. 



9.10 Maintaining the System 

This section indicates some events and files which must be maintained for the uucp 
system. You may do some maintenance with shell command files, initiating the files 
with crontab entries. Others will require manual modification. Some sample shell 
files are given toward the end of this section. 
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9.10.1 SEQF - sequence check file 

This file is set up in the program directory and contains anentry for each remote system 
with which you agree to perform conversation sequence checks. The initial entry is 
just the system name of the remote system. The first conversation will add two items to 
the line, the conversation count, and the date/time of the most resent conversation. 
These items will be updated with each conversation. If a sequence check fails, the 
entry willha veto be adjusted. 

U se of this feature is not recommend. 

9.10.2 TM - temporary data files 

These files are created in the spool directory while files are being copied from a remote 
machine. Their nameshavethe form 

TM. pid.ddd 

where /wtfisa process— id and ddd is a sequential three digit number starting at zero for 
each invocation of uucico and incremented for each file received. 

After the entire remote file is received, the TM file is moved/copied to the requested 
destination. If processing is abnormally terminated orthe move/copy fails, the file will 
remain in the spool directory . 

The leftover files should be periodically removed; the uuclean program isuseful in this 
regard. The command 

uuclean — pTM 

removes all TM files older than three days. 

9.10.3 LOG -log entry files 

During execution of programs, individual LOG files are created in the spool directory 
with information about queued requests, calls to remote systems, execution of uux 
commands and file copy results. These files should be combined into the LOGFILEby 
using the uulog program . This program will put the new LOG files at the beginning of 
the existing LOGFILE. The command 

uulog 

performs the merge. Options are available to print some or all the log entries after the 
files are merged. The LOGFILE should be removed periodically since it iscopied each 
time new LOG entriesareput into the file. 

The LOG files are created initially with mode 0222. If the program which creates the 
file terminates normally, itchangesthemodeto0666. Aborted runs may leave the files 
with mode 0222 and the uulog program will not read or remove them. To remove 
them, either use rm , uuclean , or change the mode to 0666 and let uulog merge them 
vfiihihcLOGFILE. 
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9. 10.4 STST - system status files 



These files are created in the spool directory by the uucico program. They contain 
information of failures such as login, diahip or sequence check and will contain a 
talking status whentomachinesareconversing. The form ofthe file name is 

STST.sys 

where sys isthe remote system name. 

For ordinary failures (dialup, login), the file will prevent repeated tries for about one 
hour. For sequence check failures , the file must be removed before any future attempts 
to converse with that remote system. 

If the file is left due to an aborted run, it may contain a talking status, lnthiscase, the file 
must be removed before a conversation is attempted. 

9.10.5 LCK- lock files 



Lock files are created for each device in use (e.g. automatic calling unit) and each 
system conversing. This prevents duplicate conversations and multiple attempts to 
use the same devices . The form ofthe lock file name is 

LCK. sir 

where str is either a device or system name. The files may be left in the spool directory 
if runs abort . They will be ignored (reused) after a time of about 24 hours. When runs 
abort and calls are desired before the time limit, the lock files should be removed. 



9.10.6 Creating Shdl Files 

The uucp program will spool work and attempt to start the uucico program, but the 
starting of uucico will sometimes fail. (No devices available, login failures etc.). 
Therefore, the uucico program should be periodically started. The command to start 
uucico can be put in a shell file with a command to merge LOG files and started by a 
crontab entry on anhourly basis. The file could contain the commands 

program /uulog 
program /uucico — rl 

Note that the — r 1 option is required to start the uuc/coprogram inMASTER mode. 

Another shell file may be set up on a daily basis to remove TM , ST, and LCK files and 
C. or D. files for work which can not be accomplished for reasons like bad phone 
number, login changes etc. A shell file containing commands like 

program /uuclean — pTM — pC. — pD. 
program /uuclean — pST — pLCK — nl2 

can be used. Note the -nl2 option causestheST and LC£ files older than 12 hours to 
be deleted . The absence of the — n option will use a three day time limit . 
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9.10.7 Defining Login Entries 

One or more logins should be set up for uucp . Each of the letclpasswd entries should 
have programluucico as the shell to be executed (where program is the directory 
containing uucico). The login directory is not used, but if the system has a special 
directory for use by the users for sending or receiving file, it should as the login entry. 
The various logins are used in conjunction with the USERFILE to restrict file access. 
SpecifymgtheshellargumentlimitsthelogintotheuseofMJicicoonly. 

'■). 10.8 Setting Ffle Modes 

It is suggested that the owner and file modes of various programs and files be set as 
follows. 

The programs uucp , uux , uucico , and uuxqt should be owned by the uucp login with 
the setuid bit set and only execute permissions (e.g. mode 041 1 1 ). This will prevent 
outsiders from modifying the programs to get at a standard shell for the uucp logins. 

The L.sys, SQFILE, and USERFILE files which are put in the program directory 
should be owned by the uucp login and set with mode 0400. 
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The C-ShcU 



10.1 Introduction 

The C- shell program, csh, is a command language interpreter for XENIX system 
users. TheC— shell, like the standard XENIX shell sh, is an interface between you and 
the XENIX commands and programs. It translates command lines typed at a terminal 
intocorrespondingsystem actions, givesyouaccesstoinformat ion, such as your login 
name, home directory, and mailbox, and lets you construct of shell procedures for 
automating system tasks. 

This chapter explains how to use the C— shell. It also explains the syntax and function 
of C— shell commands and features, and showshowtouse these featuresio create shell 
procedures. The C- shell is fully described in csh(CP) in the XENIX Reference 
Maraud. 

10.2 Invoking the C-shell 

Y ou can invoke theC-shell from another shell by using the csh command. Toinvoke 
the C- shell, type: 

csh 

at the standard shell's command line. You can also direct the system to invoke the 
C-shell for you when you log in. lfyouhavegiventheC— shell as your login shell in 
y our /£fc//xmwd file entry , the system automatically startsthe shell whenyou log in. 

After the system starts the C— shell, the shell searches your home directory for the 
command files, cshrc and. login. Ifthe shell finds the files, it executes the commands 
contained in them, then displays the C-shell prompt. 

The .cshrc file typically contains the commands you wish to execute each time you 
start a C- shell, and the .login file contains the commands you wish to execute after 
logging in to the system. For example, the following is the contents of a typical .login 
file: 

set ignoreeof 

set mail=(/usr/spool/mail/bill) 

set time= 15 

set history =10 

mail 

Thisfilecontainsseveralsetcommands. The set command is executed directly by the 
C— shell; there is no corresponding XENIX program for this command. Set sets the 
C— shell variable "ignoreeof which shields the C— shell from logging out if 
CNTRL-D is hit. Instead of CNTRL-D, the logout command is used to log out of the 
system. By setting the "mail" variable, the C-shell is notified that it is to watch for 
incomingmailand notify you if new mail arrives. 

Next the C— shell variable ' 'time* ' is set to 1 5 causing the C- shell to automatically 
print out statistics lines for commands that execute for at least 1 S seconds of CPU time. 
The variable * 'history' ' is set to 1 indicating that the C— shell will remember the last 
10commandstypedinitshistorylist,(describedlater). 

Finally, the XENIX mo/7 program is invoked. 

When the C— shell finishes processing the .login file, it begins reading commands 
from the terminal, prompting for each with: 
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Whenyoulogout (by givingthelogoutcommand)theC- shell prints 

logout 

and executes commands from the file .logout Hit exists in your home directory. After 
that, theC-sheUterminatesandXENIX logs you offthe system. 

10.3 Using Shell Variables 

The C- shell maintains a set of variables. For example, in the above discussion, the 
variables "history'* and "time" had the values 10 and 15. Each C— shell variable has 
as its value an array of zero or more strings. C— shell variablcsmay be assigned values 
by the set command, whichhas several forms, the most useful of which is: 

set name= value 

C— shell variables may be used to store values that are to be used later in commands 
through a substitution mechanism. The C— shell variables most commonly 
referenced are, however, those that the C- shell itself refers to. By changing the 
values of these variablesyoucandirectryaffecttlie behavior ofttieC- shell. 

One of the most important variables is "path". This variable containsalist of directory 
names. When you type a command name at your terminal, the C— shell examineseach 
named directory in turn, until it finds an executable file whose name corresponds to the 
name you typed. The set command with no arguments displays the values of all 
variables currently defined in the C— shell. The following example shows a typical 
default values: 



argv 
home 



/usr/bill 


path 


(. /bin /usr/bin) 


prompt 
shell 


% 
/bin/csh 


status 






This output indicates that the variable "path" begins with the current directory 
indicated by dot ( . ), then /bin, and lusrlbin. Your own local commands may be in the 
current directory. Normal XENIX commands reside in/binand/usr/btn. 

Sometimes a number of locally developed programs reside in the directory lusrl local . 
If you want all C- shells that you invoke to have access to these new programs, place 
the command 

set path=(. /bin /usr/bin Aisr/local) 

in the .cshrc file in your home directory. Try doing this, then re- executing you .login 
with the command sonrcdogin. Type 

set 

to see that the value assigned to "path" has changed. 

You should be aware that when you log in the C- shell examines each directory that 
you insert into your path and determines which commands are contained there, except 
for the current directory which the C— shell treats specially, This means that if 
commands are added to a directory in your search path after you have started the C- 
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shell , they will not necessarily be found. If you wish to use a command which has been 
added alter you have logged in, you should give the command 

rehash 

to the C— shell. Rehash causes the shell to recompute its internal table of command 
locations, sothat it will find the newly added command. Since theC— shell has to look 
in the current directory on each command anyway, placing it at the end of the path 
specificationusually work:; best and reduces overhead. 

Other useful built in variables arc "home" which shows your home directory, and 
' 'ignoreeof ' which can be set in your . login file to tell the C— shell not to exit when it 
receives an end— of — file from a terminal . The variable ' 'ignoreeof * is one of several 
variables whose value the C— shell does not care about; the C— shell isonly concerned 
with whether these variables are set or unset. Thus, to set "ignoreeof you simply 
type 

set ignoreeof 

and to unset it type 

unset ignoreeof 

Some other useful built— in C-shell variables are "noclobber" and "mail". The 
syntax 

> filename 

which redirects the standard output of a command just as in the regular shell, 
overwrites and destroys the previous contents of the named file. In this way, you may 
accidentally overwrite a file which is valuable. If you prefer that the C— shell not 
overwrite files in this way you can 

set noclobber 
in your, login file, typing 

date > now 
causes an error message if the file now already exists. You can type 

date >! now 

if you really want to overwrite the contents of now. The ">!" is a special syntax 
indicating mat overwriting or "clobbering" the file is ok. (The space between the 
exclamation point (!) and the word "now" is critical here, as "!now" would be an 
invocation of the history mechanism, described below, and have a totally different 
effect.) 

10.4 Using the C -Shell History List 

The C— shell can maintain a history list into which it places the text of previous 
commands. It is possible to use a notation that reuses commands, or words from 
commands, in forming new commands. This mechanism can be used to repeat 
prcviouscommandsortocorrectminortypingmistakesincommands. 

The following figure gives a sample session involving typical usage of the history 
mechanismofthe C-shell. Boldface indicatesuser input: 
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% cat bug.c 

main() 



printf("hello); 

i 

% cc !$ 

cc bug.c 

"bug.c", line 4: newline in string or char constant 

"bug.c", line 5: syntax error 

%ed!$ 

ed bug.c 

29 

4s/);T&/p 

printf("hello"); 
w 
30 

q 

%\c 
cc bug.c 
% a.out 
hello% !e 
ed bug.c 
30 
4s/lo/lo\Wp 

printf("hello\n"); 
w 
32 

q 

% !c — o bug 

cc bug.c — o bug 

% size a. out bug 

a.out: 2784+364+1028 = 4176b = 0x1050b 

bug: 2784+364+1028 = 4176b = 0x1050b 

%!$-!!• 

Is —1 a.out bug 

-rwxr-xr-x 1 bill 3932 Dec 19 09:41 a.out 

-rwxr-xr-x 1 bill 3932 Dec 19 09:42 bug 

% bug 

hello 

% pr bug.c I Ipt 

lpt: Command not found. 

% 'Ipt'lpr 

pr bug.c I Ipr 

% 

In this example, we have a very simple C program that has a bug or two in the file 
bug.c, which we cat out on our terminal. We then try to run the C compiler on it, 
referring to the file again as "!$", meaning the last argument to the previous 
command. Here the exclamation mark (!) is the history mechanism invocation 
metacharacter, and the dollar sign($) stands for the last argument, by analogy to the 
dollar sign in the editor which stands for the end— of— line. The C— shell echoed the 
command, as it would have been typed without useof the history mechanism, and then 
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executed the command. The compilation yielded error diagnostics, so we now edit tne 
tile we were trying to compile, fix the bug, and run the C compiler again, this time 
referring tothis command simply as " !c" , which repeats the last command that started 
with the letter "c". If there were other commands beginning with the letter "c" 
.executed recently, we could have said "!cc" or even "!cc:p" which prints the last 
. ommand starting with " cc " without executing it , so that you can check to see whether 
you really want toexecute agivencommand. 

After this recompilation, we ran the resulting a. our file, and then noting that there still 
was a bug, ran the editor again. After fixing the program we ran the C compiler again, 
but tacked onto the command an extra *'— o bug" telling the compiler to place the 
resultant binary in the file bug rather than a.out. In general, the history mechanisms 
may be used anywhere in the formation of new commands, and other characters may 
be placed before and after the substituted commands. 

We then ran the size command to see how large the binary program images we have 
created were, and then we ran an "Is —1" command with the same argument list, 
denoting the argument list: 



Finally , we ran the program bug to sec that its output i s indeed correct . 

To make a listing of the program, we ran the pr command on the file bug.c. lnorderto 
print the listing at a lineprinter we piped the output tolpr , but misspelled it as 4 ' Ipt" . To 
correct this we used a C— shell substitute, placing the old text and new text between 
caret (*)characters. This is similartothesubstitutecommandinthe editor. Finally, we 
repeated the same command with 



and sent its output to the lineprinter. 

There are other mechanisms available for repeating commands. The history 
command prints out a numbered list of previous commands. You can then refer to 
these commands by number. There is a way to refer to a previous command by 
searching for a string which appeared in it, and there are other, less useful, ways to 
select arguments to include in a new command. A complete description of all these 
mechanisms is gjivcnmcsh(CP)lhcXEN]XReference Manual . 

10.5 Using Aliases 

The C— shell has an alias mechanism that can be used to make transformations on 
commands immediately after they are input . This mechanism can be used to simplify 
the commands you type, to supply default arguments to commands, or to perform 
transformations on commands and their arguments. The alias facility is similar to a 
macro facility. Some of the features obtained by aliasing can be obtained by using 
C- shell command files, but these take place in another instance of the C— shell and 
cannot directly affect the current C— shell's environment or involve commands such 
as cd which must be done in the current C— shell. 

For example, suppose there is a new version of the mail program on the system called 
newmail that you wish to use instead of the standard mail program mail. If you place 
the C— shell command 
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alias mail newmail 

in your .cshrc file , the C— shell will transform an input line of the form 

mail bill 

intoacaIlon/tiwsna/7. Supposeyouwishthecommandlstoalwaysshowsizesoftiles, 
that is, to always use the — s option. In this case , you can use the alias command to do 

alias Is Is — s 
oreven 

alias dir Is — s 
creating a new command named dir. If we then type 

dir "bill 
the C— shell translates this to 

Is -s/usr/bill 

Note that the tilde (") is a special C— shell symbol that represents the user's home 
directory. 

Thus the alias command can be used to provide short names for commands, to provide 
default arguments, and to define new short commands in terms of other commands. It 
is also possible to define aliases that contain multiple commands orpipelines, showing 
where the arguments to the original command are to be substituted using the facilities 
ofthe history mechanism. Thusthedefinition 

alias cd 'cd \!* ; Is * 

specifies an Is command after each cd command. We enclosed the entire alias 
definition in single quotation marks ( * ) to prevent more substitutions from occurring 
and to prevent the semicolon (;) from being recognized as a metacharacter. The 
exclamationmark (!) is escaped with a backslash (\) to prevent it from being interpreted 
whenthe alias command is typed in. The * V* " here subst it utestheentire argument list 
to the prealiasing cd command; no error is given if there are no arguments. The 
semicolon separating commands is used here to indicate that one command is to be 
done and then the next . Similarly the following example defines a command that looks 
up its first argument in the password file. 

alias whois 'grep \!" /etc/passwd' 

The C- shell currently reads the .cshrc file each time it starts up. If you place a large 
number of aliases there, C— shells willtend to start slowly. You should try to limit the 
number of aliases you have to a reasonable number ( 1 or 1 5 is reasonable). Too many 
aliases causes delays and makes the system seem sluggish when you execute 
commandsfxomwithinaneditororotherprograms. 

10.6 Redirecting Input and Output 

In addition to the standard output, commands also have a diagnostic output that is 
normally directed to the terminal even when the standard output is redirected to a file or 
a pipe. It is occasionally useful to direct the diagnostic output along with the standard 
output. For instance, ifyou want to redirect the output ofa long running command into 
a file and wish tohave a record of any error diagnostic it produces you can type 
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command > & file 

The " > &" here tells the C— shell to route both the diagnostic output and the standard 
output inlofile . Similarly you can give the command 

command I & Ipr 

to route both standard and diagnostic output through the pipe to the lineprinter. The 
form 

command >&! file 
is used when "noclobber" is set and/i/* already exists. 
Finally, use the form 

command » file 

to append output to the end of an existing file. If "noclobber" is set, then an error 
results if file does not exist , otherwise theC— shell creates^/*' . The form 

command >>! file 

lets you append to a file even if it does not exist and "noclobber" is set. 

10.7 Creating Background and Foreground Jobs 

When one or more commands are typed together as a pipeline or as a sequence of 
commands separated by semicolons, a single job is created by the C— shell consisting 
of these commands together as a unit. Single commands without pipes or semicolons 
create the simplest jobs. Usually, every line typed to the C— shellcreatesajob. Each of 
the following lines creates a job: 

sort < data 

Is — s I sort — n I head —5 

mail harold 

If the ampersand metacharacter (&) is typed at the end of the commands, then the job is 
started as a background job. This means that the C— shell does not wait for the job to 
finish, but instead, immediately prompts for another command. The job runs in the 
background at the same time that normal jobs, called foreground jobs, continue to be 
readandexecutedbytheC— shell. Thus 

du > usage & 

runs the du program, which reports on the disk usage of your working directory, puts 
the output into the file usage and returns immediately with a prompt for the next 
command without waiting for du to finish . The du program continues executing in the 
background until it finishes, even though you cantype and execute more commands in 
the mean time. Background jobs are unaffected by any signals from the keyboard such 
as the INTERRUPT or QUIT signals. 

The kfll command terminates a background job immediately. Normally, this is done 
by specifying the process number of the job you want killed. Process numbers can be 
found with the ps command. 
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10.8 Using Built-in Commands 

This sect ionexplainshow to use some of the built— inC— shell commands. 

The alias command described above is used to assign new aliases and to display 
existing aliases. If given no arguments, alias prints the list of current aliases. It may 
also be given one argument, such as to show the current alias for a given string of 
characters. For example 

alias Is 

printsthe currentalias for the string ' is" . 

The history command displays the contents of the history list. The numbers given 
with the history events can be used to reference previous events that are difficult to 
reference contextually. There is also a C— shell variable named "prompt". By 
placing an exclamation point (!) in its value the C— shell will substitute the number of 
the current command in the history list. You can use this numberto refer to a command 
in ahistory substitution. For example, you could type: 

set prompt='\! % * 

Note that the exclamation mark (!) had to be escaped even within backslashes. 

The logout command isused to terminate a login C— shell that has ' 'ignoreeof * set . 

The rehash command causes the C— shell to recompute a table of command locations. 
This is necessary if you add a command to a directory in the current C— shell * s search 
path and want the C- shell to find it , since otherwise the hashing algorithm may tell the 
C— shell that the command wasn't in that directory whenthe hash table wascomputed. 

The repeat command is used to repeat a command several times. Thus to make 5 
copiesof the fileom in the fileyivryou could type: 

repeat 5 cat one » five 

The setenv command canbeusedto set variablesintheenvironment. Thus 

setenv TERM adm3a 

sets the value of the environment variable "TERM" to "adm3a". The program env 
exists to print out the environment. Forexample, itsoutput might looklike this: 

HOME=/usr/bill 

SHELL=/bin/csh 

PATH = :/usr/ucb:/bin:/usr/bin:/usr/local 

TERM=adm3a 

USER=bill 

The source command is used to force the current C— shell to read commands from a 
file. Thus 

source .cshrc 

can be used after editing in a change to the . cshrc file that you wish to take effect before 
the next time you login. 

The time command is used to cause a command to be timed no matter how much CPU 
time it takes. Thus 
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time cp /etc/rc /usr/biU/rc 
displays: 

O.Ou 0.1s 0:01 8% 
Similarly 

time wc /etc/rc /usr/bill/rc 

displays: 

52 178 1347 /etc/rc 
52 178 1347 /usr/bill/rc 
104 356 2694 total 
O.lu 0.1s 0:00 13% 

This indicates that the cp command used a negligible amount of user time (u) and about 
l/10th of a second system time (s); the elapsed time was 1 second (0:01). The word 
count command wc used 0. 1 seconds of user time and 0. 1 seconds of system time in 
less than a second of elapsed time. The percentage "13%" indicates that over the 
period when it was active the wc command used an average of 13 percent of the 
available CPU cycles of the machine . 

The unalias and unset commands are used to remove aliases and variable definitions 
from the C- shell. 

10.9 Creating Command Scripts 

It is possible to place commands in files and to cause C— shells to be invoked to read 
and execute commands from these files, which are called C— shell scripts. This 
section describes the C— shell features that are useful whencreating C— shell scripts. 

10. 10 Using the argv Variable 

Acsh command script may be interpretedby saying 

csh script argument ... 

where script is the name of the file containing a group of C— shell commands and 
argument is a sequence of command arguments. The C— shell places these arguments 
in the variable "argv" and then begins to read commands from script. These 
parameters are then available through the same mechanisms that are used to reference 
any otherC— shell variables. 

If you make the file script executable by doing 

chmod 755 script 
or 

chmod +x script 

and then place a C— shell comment at the beginning of the C— shell script (i.e. , begin 
the file with a number sign (#) ) then IbinJcsh will automatically be invoked to execute 
script when you type 
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script 



If the file does not begin with a number sign (#) then the standard shell IbinJsh will be 
used to execute it. 

10.11 Substituting SheU Variables 

After each input line is broken into words and history substitutions are done on it, the 
input line is parsed into distinct commands. Before each command is executed a 
mechanism know as variable substitution is performed on these words. Keyed by the 
dollar sign ($), this substitutionreplaces the namesof variables by their values. Thus 

echo $argv 

whenplaced in a command script would cause the current value of the variable ' * argv ' ' 
to be echoed to the output of the C— shell script. It is an error for * 'argv' ' to be unset at 
this point. 

A number of notations are provided for accessing components and attributes of 
variables. The notation 

%!name 

expands to 1 if name is set or to if name is not set. It is the fundamental mechanism 
used for checking whether particular variables have been assigned values. All other 
forms ofreference to undefined variables cause errors. 

The notation 

$#name 

expands to the number of elements in the variable "name". To illustrate, examine the 
following terminal session (input is in boldface): 

% set argv=(a b c) 

1 

% echo $#argv 

3 

% unset argv 

% echo $?argv 

% echo $argv 
Undefined variable: argv. 

% 

it is also possible to access the components of a variable thathas several values. Thus 

$argvfl] 
givesthefirstcomponentof"argv"orintheexampleabove"a". Similarly 

$argvf$#argv] 
would give "c ", and 

$argvfl-2l 
would give: 
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ab 
Other notations useful inC — shell scripts are 

$n 
where n is an integer This is shorthand for 

$argvf n } 
the n 'th parameter and 

$* 
which is a shorthand for 

$argv 
The form 

$$ 

expands to the process number of the current C— shell. Since this process number is 
unique in the system, it is often used in the generation of unique temporary filenames. 
The form 

$< 

is quite special and is replaced by the next line of input read from the C— shell's 
standard input (not the script it is reading). This is useful for writing C— shell scripts 
that are interactive, reading commands from the terminal, or even writing a C— shell 
script that acts asa filter, reading lines from its input file. Thus, the sequence 

echo ~n 'yes or no?' 
set a=($<) 

write s out the prompt 

yes or no? 

without a newline and then reads the answer into the variable ' V . In this case ' *$#a " 
is Oif either a blank line or CNTRL-D is typed. 

One minor difference between "$«' * and ' '$argvf n ]' * should be noted here. The form 
"$argvf/i 1" will yield an error if nis not in the range l—$#argv while "$n" will never 
yield an out— of— range subscript error. This is for compatibility with the way older 
shells handle parameters. 

Another important point isthat it isneveranerrortogive a subrangeof the form "n- "; 
if there are less than "n" components of the given variable then no words are 
substituted. A range of the form ' 'm— n" likewise returns an empty vector without 
giving an error when "m" exceeds the number of elements of the given variable, 
provided the subscript M n" is inrange. 

10.12 Using Expressions 

To construct useful C— shell scripts, the C— shell must be able to evaluate expressions 
based on the values of variables. In fact, all the arithmetic operationsof the C language 
are available in the C— shell with the same precedence that they have in C. In 
particu lar, the operations "==■** and ' *! =" compare strings and the operators "&&' * 
and"l I "implement the logical AND and OR operations. The special operators "=~" 
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and " !"" are similar to " = = " and * * ! = " except that the string on the right side can 
have pattern matching characters (like * , ? or f and j). These operators test whether the 
string on the le ft matches the pattern on the right . 

TheC— shell alsoallowsfileenquiriesoftheform 

— ? filename 

where question mark (?) is replaced by a number of single characters. For example, 
theexpressionprimitive 

— t filename 

tells vihtihzt filename exists. Other primitives test for read, write and execute access to 
the file, whether it isadirectory, or if it has nonzero length. 

It is possible to test whether a command terminates normally, by using a primitive of 
the form 

{ command j . ■ 

which returns 1 if the command exitsnormally with exit status 0, or if the command 
terminate s abnormally or with exit status nonzero. If more detailed information about 
the execution status of a command is required, it can be executed and the * 'status* ' 
variable examined in the next command. Since "$status" is set by every command, 
its value is always changing. 

For the full list of expression components, see csh(CP). in the XENIX Reference 
Manual. 

10.13 Using the C-Shell: A Sample Script 

A sample C— shell script follows that uses the expression mechanism of the C~ shell 
and some of its control structures: 
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# 

# Copyc copies those C programs in the specified list 

# to the directory "/backup if they differ from the files 

# already in "/backup 
# 

set noglob 
foreach i ($argv) 

if ($i !" *.c) continue # not a .c file so do nothing 

if (! -r "/backup/$i:t) then 

echo $i:t not in backup... not cpVed 

continue 
endif 

cmp — s $i 7backup/$i:t # to set Sstatus 

if (Sstatus != 0) then 

echo new backup of $i 
cp $i 7backup/$i:t 
endif 
end 

This script uses the foreach command. The command executes the other commands 
between the foreach and the matching end. for each of the values given between 
parentheses with the named variable "i" which is set to successive values in the list. 
Within this loop we may use the command break to stop executing the loop and 
continue to prematurely terminate one iteration and begin the next. After the foreach 
loop theiterat ion variable(/inlhiscase)hasthevalueatthe last iteration. 

The "noglob" variable is set to prevent filename expansion of the members of 
"argv". This is a good idea, in general, if the arguments to a C— shell script are 
filenames which have already been expanded or if the arguments may contain filename 
expansion metacharacters. It is also possible to quote each use of a "$" variable 
expansion, but this isharder and lessre liable . 

The other control construct is a statement of the form 

if ( expression ) then 
command 

endif 

The placement of the keywords in this statement is not flexible due to the cunent 
implementation of the C— shell. The following two formats are not acceptable to the 
C- shell: 

if (expression) # Won't work! 
then 

command 

endif 
and 
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if (expression) then command endif # Won't work. 
The C— shell doeshaveanother form of the if statement: 

if ( expression ) command 

which can be written 

if ( expression ) \ 
command 

Here we have escaped the newline for the sake of appearance. The command must not 
involve " I ", "&" or ";" and must not be another control command. The second 
form requires the final backslash (\) to immediately precede the end-of- line. 

The more general if statements above also admit a sequence of else- if pairs followed 
by a single else and an endif, for example: 

if ( expression ) then 

commands 
else if (expression ) then 

commands 



else 

commands 
endif 

Another important mechanism used in C— shell scripts is the colon (:) modifier. We 
can use the modifier :r here to extract the root of a filename or :e to extract the 
extension. Thus if the variable "i'*hasthevaluc/mn///Jx>.Aarthen 

echo $i $i:r $i:e 

produces 

/mnt/foo.bar /mnt/foo bar 

This example shows how the :r modifier strips off the trailing ".bar" and the :e 
modifier leaves only the "bar". Other modifiers take off the last component of a 
pathname leaving the head :h or all but the last component of a pathname leaving the 
tail : t. These modifiers are fully described in the csh(CP) entry in the XENIX Reference 
Manual . It is also possible to use the command substitution mechanism to perform 
modifications on strings to then reenter the C— shell environment. Since each usageof 
this mechanism involves the creation of a new process, it is much more expensive to 
use than the colon (:) modification mechanism. It is also important to note that the 
current implementation of the C— shell limits the number of colon modifiers on a "$ " 
substitution to 1 . Thus 

% echo $i $i:h:t 
produces 

/a/b/c /a/b:t 

and does not do what you might expect. 

Finally, we note that the number sign character (#) lexically introduces a C— shell 
comment in C— shell scripts (but not from the terminal). All subsequent characters on 
the input line after a number sign are discarded by the C— shell. This character can be 
quoted using "'"or "argument word. 
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10.14 Using Other Control Structures 

The C— shell also has control structures wkDe and switch similar to those of C. These 
take the forms 

while ( expression ) 
commands 
end 

and 

switch ( word ) 

case strl: 

commands 
breaksw 



case strn: 



default: 



commands 
breaksw 



commands 
breaksw 



endsw 

For details see the manual section for csh(CP). C programmers should note that weuse 
breaksw to exit from a switch while break exits a while or foreach loop. A common 
mi stake to make in C— shell scripts is to use break rather than breaksw in switches. 

Final ly , the C - shell allows a goto statement , with labels looking like they do in C: 

loop: 

commands 
goto loop 

10. 15 Supplying Input to Commands 

Commands run from C— shell scripts receive by default the standard input of the C— 
shell which is running the script. It allows C— shell scripts to fully participate in 
pipelines, butmandatesextranotationforcommandsthataretotakeinlinedata. 

Thus we need a metanotation for supplying inline data to commands in C— shell 
scripts. For example, considerthis script which runstheeditortodelete leading blanks 
from the lines in each argument file: 
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# dcblank remove leading blanks 

foreach i ($argv) 
ed - $i « ' EOF' 

l,$sf[|*// 
w 

q 

•EOF' 
end 

The notation 

« 'EOF' 

means that the standard input for the ed command is to come from the text in the C- 
shell script file up to the next line consisting of exactly EOF. The fact that the EOF is 
enclosed in single quotation marks ( ' ), i.e., it is quoted, causes the C— shell to not 
perform variable substitution on the intervening lines. In general, if any part of the 
word following the " « " which the C- shell uses to terminate the text tobe given to 
the command is quoted then these substitutions will not be performed. In this case 
since we used the form " 1 ,$" in our editor script we needed to insure that this dollar 
sign was not variable substituted. We could also have insured this by preceding the 
dollarsign($)withabackslash(\),i.e.: 

l,\$sT[]*// 

Quoting the EOF terminator is a more reliable way of achieving the same thing. 

10.16 Catching Interrupts 

If ourC— shell script creates temporary files, we may wish to catch interruptions of the 
C— shell script so that wecan cleanup these files. We canthendo 

onintr label 

where label is a label in our program. If an interrupt is received the C— shell will do a 
' 'goto label" and we canremove the temporary files, thendo an exit command (which 
is built in to the C— shell) to exit from the C— shell script. If we wish to exit with 
nonzero status we can write 

exit (1) 

to exit with status 1. 

10.17 Using Other Features 

There are other features of the C- shell useful to writers of C— shell procedures. The 
verbose and echo options and the related — v and — x command line options can be 
used to help trace the actions of the C— shell . The — n option causes the C— shell only 
to read commands and not to execute them and may sometimes be of use. 

One other thing to note is that the C— shell will not execute C— shell scripts that do not 
begin with the number sign character (#), that is C— shell scripts that do not begin with 
a comment. 

There is also another quotation mechanism using the double quotation mark ("), which 
allows only some of the expansion mechanisms we have so far discussed to occur on 
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the quoted string and serves to make this string into a single word as the single quote ( ' ) 
does 

10. 18 Starting a Loop at a Terminal 

It is occasionally useful to use the foreach control structure at the terminal to aid in 
performing a number of similar commands. For instance , if there were three shells in 
u se on a part icular system , Ibinlsh , Ibinlnsh , and/ bin/csh , you could count the number 
ofpersons using each shellbyusing the following commands: 

grep — c csh$ /etc/pass wd 
grep — c nsh$ /etc/passwd 
grep — c — v sh$ /etc/passwd 

S incc these commands are very similar we canuse foreach to simplify them: 

$ foreach i ('csh$' 'nsh$' »-v sh$») 

? grep -c $i /etc/passwd 

?end 

Note here that the C— shell prompts for input with " ? " when reading the body of the 
loop . This occurs only when the foreach command is entered interactively. 

Also useful with loops are variables that contain lists of filenames or other words. For 
example, examine the followingterminal session: 

%seta=Ck') 

% echo $a 

csh.n csh.rm 

%ls 

csh.n 

csh.rm 

% echo $#a 

2 

The set command here gave the variable "a " a list of all the filenames in the current 
directory as value. We can then iterate over these names to perform any chosen 
function. 

The output of a command within back quotation marks ( ' ) is converted by the C— shell 
to a list of words. You can also place the quoted string within double quotation marks 
(") to take each (nonempty) line as a component of the variable. This prevents the lines 
from being split into words at blanks and tabs. A modifier :x exists which can be used 
later to expand each component of the variable into another variable by splitting the 
original variable into separate words at embedded blanks and tabs. 

10.19 Using Braces with Arguments 

Another form of filename expansion involves the characters, "{" and "J". These 
characters specify that the contained strings, separated by commas (,) are to be 
consecutively substituted into the containing characters and the results expanded left to 
right. Thus 

A;strl,str2,...strnjB 
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expands to 

AstrlB Astr2B ... AstrnB 

This expansion occurs before the other filename expansions, and may be applied 
recursively (i.e. , nested). The results of each expanded string are sorted separately, 
left to right order being preserved. The resulting filenames are not required to exist if 
no other expansion mechanisms are used . This means that this mechanism can be used 
to generate arguments which are not filenames, but which have common parts. 

Atypical use of this would be 

mkdir 7ihdrs,retrofit,cshj 

to make subdirectories hdrs , retrofit and csh in your home directory. This mechanism 
is most useful when the common pre fix is longer than in this example: 

chown root /usr/demo/jfilel,file2,...j 

10.20 Substituting Commands 

A command enclosed in accent symbols ( ' ) is replaced, just before filenames are 
expanded, by theoutput from that command. Thus, impossible todo 

set pwd^'pwd' 

to save the current directory in the variable "pwd' ' or to do 

vi grep -1 TRACE *.c* 

to run the editor vi supplying as arguments those files whose names end in .c which 
have the string "TRACE" in them. Command expansion also occurs in input 
redirected with "«" and within quotation marks ("). Refertocsh(CP)in the XENIX 
Reference Manual formore information. 

10.21 Special Characters 

The following table lists the special characters of csh and the XENIX sy stem . A number 
of these characters also have special meaning in expressions. See the csh manual 
section for a complete list. 

Syntactic metacharacters 

; Separatescommandstobeexecutedsequentially 

I Separates commands in a pipeline 

() Bracketsexpressions and variable values 

& Followscommandstobe executed without waiting for completion 

Filename metacharacters 

/ Separatescomponentsofafile'spathname 
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Separates root pan s of a ti lename from extensions 
? Expansion character matching any single character 

* Expansion charactermatching any sequence of characters 

j ] Expansionsequencematchinganysinglecharacterfromasetofcharacters 

Used at the beginning of a filename to indicate home directories 

II Usedtospecifygroupsofargumentswithcommonparts 
Quotation metacharacters 

\ Preventsmeta— meaning of following single character 

Preventsmeta— meaning ofa group of characters 

Like ' , but allows variable and command expansion 
Input/outputmetacharacters 

< Indicates redirected input 

> Indicates redirected output 

Expansion/SubstitutionMetacharacters 

$ Indicates variable substitution 

! Indicateshistory substitution 

Precedes substitution modifier s 

Used inspecialformsofhistory substitution 

Indicates command substitution 
Other Metacharacters 

# Begins scratch filenames; indicatesC— shellcomments 
- Prefixesoption(flag)argumentstocommands 
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Using The Visual Sfaeil 

11.1 Whatis the Visual Shell? 

The Visual Shell vsh is a menu -driven XENIX shell. This chapter describes the use 
.ji:-'.«i behavior of the vsh. This chapter assumes that the reader is familiar with some 
gcneralXENIX concepts, specifically the structure of XENIX filesystems and the nature 
of a XENIX 'command'. No familiarity with any other shell, however, is assumed. If 
you are a first— time user of the Visual Shell, please completely read the narrative 
sections of this chapter. 

A 'shell* is a program which passes a command to an operating system, and displays 
the result of running the command. The XENIX shells can also create 'pipelines* for 
passing the output of one command to another command or 'redirect* the output into a 
file. 

The other XENIX shells available are sta and csh. These shells are called 
'command - line oriented ' shells. This means that the user enters commands one line 
at a time. The sh and csh shells are full computer languages which require study and 
some programming knowledge to use effectively. These command— line shells are 
powerful and efficient . 

The vsh is a 'menu— oriented' shell. In a menu— oriented shell, the user is given the 
available commands, or some of the available commands. The user can run the 
command, by selecting from the menu. 

The Visual Shell is a good shell for users who may not want to master a programming 
language right away just to use XENIX or a specfic XENIX application. All Visual Shell 
users should additionally become familiar with some command— line shell usage. 

Users familiar with command— line shells are in for a pleasant surprise if they try the 
Visual Shell. Experienced users will appreciate the efficiency and versatility of the 
Visual Shell. The distinction is very much akin to the difference between a line- 
oriented text editor and a full -screen editor. 

A menu shell can be used effectively with very little study. On the other hand, a menu 
shell can also restrict the user from using the operating system in creative, possibly 
more efficient ways. The Microsoft Visual Shell strikes a balance in this regard. The 
V isual Shell is designed to do all of the things that the command - line shells can do. 

11.2 Getting Started with the Visual Shell 

This section describes how to enter, obtain help about, and leave the visual shell. This 
section also describes what you will see on the screen while running the visual shell and 
how the menus work. 

Note the following convention for specifying keystrokes. CTRL refers to the CTRL 
shiftkey. CTRL-CmeanspressingtheCTRLand'c'keysatthesametime. ALTrefers 
to the ALT shift key. ALT-H means pressing the ALT and 'H' keys at the same time. 
Note the irrelevance of case inentering Menu Selection characters. For instance, press 
either 'Q* or 'q* torun the ' 'Quit' ' command from the main menu . 

11.2.1 Entering the Visual Shell 
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Log in to XENIX If you are not sure how to log in, consult the Operations Guide or 
have someone knowlegeable about XENIX help you. When you have a shell prompt 
(typically '$' or '%'), the operating system is waiting for a command. Enter the 
command: 

vsh 

and press RETURN. 

11.2.2 Getting Help 

If at anytime you are not sure what to do, either run the "Help" Menu Selection or 
press ALT - II . Refer to the reference section of this chapter for information about the 
Help command. 

11.2.3 Leaving the Visual Shell 

To exit the Visual Shell select the Quit command from the main menu. The simplest 
way to do this is to simply press 'q' or 'Q*. In response to the prompt 'Type Y to 
confirm", enter 'y'or 'Y*. If you don't want to exit the Visual Shell yet (perhaps you 
pressed 'q* by mistake), enter any other character but 'y'or'Y*. If you have invoked 
the visual shell from another shell, as described above, you will need to log out from 
XENIX by entering CTRL-D or 'logout' and pressing RETURN. If the Visual Shell is 
your default shell , you will automatically be logged out. 

11.3 The Visual Shell Screen 



11.3.1 Status Line 

The bottom line on the screen is called the 'status line*. The status line displays the 
name of the current working directory, notifies you if you have mail, and gives the 
date, time and the name of the operating system. 

1 1.3.2 Message Line 

The line above the 'status line' is called the 'message line' . The message line displays 
special output from XENIX commands, suchaserrorreports. 

11.3.3 Main Menu 

The next section of the screen above the message line is the 'main menu'. The main 
menu displays a selection of useful XENIX commands. 

The currently selected menu command is highlighted on the screen. To select any 
command, press the SPACE BAR. The next highlighted command is selected. The 
BACKSPACE key will move to the previous command. Move through the menu until 
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you have found the command you want. Torun the currently selected command, press 
RETURN. 

You may also enter the first letter of a command to select that command. If you enter 
the first letter of the command, youdonotneedtopressRETURN. 

If you entera letter which does not correspondtoamenu selection, the message 

Not a valid option 

will be displayed. Try another opt ion. 

1 1 .3. 4 Command Option Menu 

When you have selected a command , the main menu will be replaced with a command 
option menu . The command option menu give s the options available with the specific 
command. You must fill in the options with appropriate responses. 

If you wish to return to the main menu without running the command, press CTRL— C, 
(cancel). If you want torun the command with the selected optionspress RETURN. 

The following key strokes allow editing ofoption responses. 

CTRL-1, CTRL- A, or 'tab* Movetonextfieldinoptionsmenu. 

CTRL- Y or DEL Delete character under cursor. 

CTRL-L Move cursor to character to right of current position 

incurrentoptionneld. 
CTRL-K Move cursor to character to left of current position 

incurrent option field. 
CTRL-P Movecursortowordincurrentfieldtorightofthe 

current word. 
CTRL-O Movecursortowordincurrentfieldtoleftofthe 

current word. 



11.3.5 Program Output 

While running a command, commands given and output (unless redirected) will be 
displayed above the menu and below the view window. The output scrolls up: moves 
from bottom totop. Lines scrolling off the top of the output window disappear. 

Visual Shell command lines are listed with each argument preceded by the number in 
the argument list enclosed in parentheses. The command is named in the output 
window by the menu command. Hence, if you run the command /bin/Is with the 
argument — R, the output window will display the command line as follows: 

Run (1) /bin/Is (2) -R 

To change the command line format to reflect the actual XENIX command line 
generatedby the Visual Shell, use the Options Outputmenu command. 

11.3.6 View Window 

A menu of currently accessible files and directories can be displayed at the top of the 
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screen in alphabetical order, left to right, top to bottom. Note that this display is the 
same as that obtained using the view command. This will be referred to as the 'view 
window* in this chapter. If the directory list is larger than the current window size , you 
may scroll through using the key commands given below. To reset the window size, 
use the 'Window' main menu command. 

The currently selected item is highlighted in the view window . U se the arrow keys and 
other key commands given at the end of this section to move the highlight around the 
window. 

If a directory is being listed, subdirectories are shown enclosed in square brackets. To 
view a subdirectory, press '=' while the directory is highlighted. To return to the 
previous directory after viewing a subdirectory, press ' — ' . The parent directory of the 
current directory is shown as '[..]*. The current directory is shown as '[.]*. Executable 
files are preceded by an asterisk. The last modification date of the currently selected 
item is given at the right margin of the last line of the window. The name of the item in 
viewin thecurrcnt window is given in the upperright— handcomerof the window. 

The view window may also display contents of files. Highlight a file, and press ' = * . 
You may scroll through the file using the key commands given below. While viewing 
a file, the highlighted area covers one line. 

If you press * = * while an executable file is highlighted, that file will be run. 

If the Visual Shell requires a file or directory name, the currently selected View 
Window hem can be automatically entered in the relevent option field by pressing any 
directional movement key following selection of the command. This method saves 
keystrokes and reduces the chance of making typing mistakes. On the other hand, if 
you wish to explicitly enter a file or directory in an option field, type in the name after 
selecting the command . 

U se these keystrokes to select files from the view window: 

WINDOW MOTION KEYS 
CTRL -Q Move to start (first item alphabetically) of view window. 

CTRL-Z Movetoend(lastitemalphabetically)ofviewwindow. 

CTRL -R CTRL -E Scroll view window up. 
CTRL-RCTRL-S Scroll view window down. 
======== View indicated item, either file or directory . 

If no view window is present, the current working directory 

is displayed. 
— Returnwindowdisplaytoparentdirectoryof 

currently listed directory. 

If viewing a file, exit from vie wing that file . 

Last view window isreturnedto. 
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DIRECTION AL MOVEMENT KEYS 
ARROW UPorCTRL-E: Move highlight up in view window. 

ARROWDOWN orCTRL-X: Move highlight down in viewwindow. 
ARROW LEFT or CTRL - S: Move highlight left in view window. 
ARROW RIGHT or CTRL -D: Movehighlightrightinview window. 

Movement beyond the leftorright margin will proceed to the next item on the previous 
or next line unless at the edge of the view window. Movement beyond the top or 
bottom edge of the current window will scroll the view window up or down if there are 
more itemsinthat direction in the view window. 

Note that there are two ways tomove the highlight around . Eitheruse the keypad arrow 
keysortheclusteroffourkeysonthefarkftofthekeyboard'e', V.V.and'd' shifted 
with CTRL. 

While viewing a file, the directional movement keys for up and left move the highlight 
up , and the key s for down and right move the highlighted line down. 

11.4 Visual Shell Reference 



1 1.4. 1 Visual Shell Default Menu 

This section describes the default Visual Shell menu commands and options. The 
menu options are displayed at the bottom of the screen above the status line. 

To invoke a command, move the highlight forwards through the main menu using the 
space bar or the tab key, or backwards using the backspace key. Or simply press the 
first letter of the command . 

Most commands require entering options. Move the cursor to the field using the 
SPACE BAR, TAB key or BACKSPACE key, and type your response. To edit the 
options, refer to the key commands listed above in the section in this chapter labelled 
"Command Option Menu". To select an item from a View Window listing for 
insertion in a field, refertothe sectioninthischapter labelled ' ' View Window". 

Note that some options have 'switches' with predefined (default) selections. The 
currently selected switch setting is highlighted. The default is the parenthesized 
setting. Forinstance, in the switch: 

Recursive: (yes) no 

the default is recursive . To change a switch, select the field and press the SPACE BAR 
orBACKSPACE. 

Copy 

The Copy command can copy files and directories. To copy a file, select ' 'File* ' from 
the options, to copy a directory, select "Directory". A sub— menu will appear. Enter 
the file or directory you wish copied in the from: field. Enter the file or directory you 
wish copied to the to: field. Note that if the item in the to: field already exists, it will be 
overwritten, so be careful. 

The Copy Directory sub— menu has a switch ' 'recursive" . If this switch is set to yes, 
all sub - directories and their contents below the specified directory will be copied . 
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Delete 

The Delete command can remove files and directories. In the DEI£TE name: field 
enter the name of the file or directory you want to remove. Note that once the file or 
directory is deleted, the contents are gone forever unless you have another copy , so be 
careful. 

Edit 

The Edit command invokes the full- screen editor vi. The current directory will be 
displayed in the output window. Enter in the option field EDIT filename: the name of 
the file you wish to edit using vi. 

To learn vi, consult the document "vi: a Screen Editor" in the XENIX User'sGuide, 
and the vi(C) manual page in the XENIX Reference. A vi reference card is also 
available. 

Help 

The Help command (also available by pressing ALT -H at any time), can give on— line 
help regarding many aspects of Visual Shell use. The view window will display the 
help file. Use the menu to select the topic you need help with. For instance, move the 
highlight to 'Keyboard' using the SPACE BAR and press RETURN to view the help file 
starting at the 'Keyboard* section. The 'Next' and 'Previous' fields in the menu will 
scroll through the the help file from the present location one screen at a time. Your 
work will remain undisturbed. To return from Help, press CTRL-C or select the 
'Resume 'menu option. * 

Mail 

The Mail command enters the XENIX mail system. There are two options: "Send" 
and ' 'Read ' ' For more information about mail, refer to the section of the XENIX Users 
Guufcutled"Mati"orrefertoftema3(C)manualpage. 

Name 

The Name command renames an existing file or directory . There are two fields, From: 
and To: . Enter the name of the file or directory you want to rename in From: and the 
new name in Te- 



ll. 4.2 Options 

The Options Main Menu Selection provides four sub— menus. These sub— menus run 
commands which typically are used infrequently or which have irrevocable results . 

Directory Option 

The Directory command hast wo sub— menus, Make and (J sage. 

Make Directory Option This command creates a new directory named what you 
enter in the nam*: field. 

Usage Directory Option Counts the number of disk blocks in the directories specified 
in the name: field. The format is the same as the XENIX command Is — s. Refer to the 
manual pagels(C). 



11-6 



Using The Visual Shell 



FileSy stem Option 



FileSystem has the five sub— menus: Create, FilesCheck, SpaceFree, Mount and 
Unmount. 

Create FileSystem Option Create FileSystem makes a XENIX filesystem. The 
Create command performs radical system maintenance and may have irrevocable 
effects. Care isadvised whenusing Create FileSystem. 

The functionality is the same as mkfs(C). Consult the mkfs(C) manual page before 
running Create FileSystem . Create FileSystem will prompt you for device, block size, 
gap number and block number. Refer to the XENIX Operations Guide chapter on 
"Using File Systems". The section "Creating a File System" also explains this 
command. 

FilesCheck FileSystem Option FilesCheck checks the consistency of a XENIX 
filesystem and attempts repair if damage is detected. The FilesCheck command 
performs radical system maintenance and may have irrevocable effects. Care is 
advised whenusingFilesCheck. 

The functionality is the same as fsck(C). Consult the fsck(Q manual page before 
running FilesCheck. FilesCheck will prompt you forthe device to check. 

OutputOptiott 

The Output Option command has one switch, commands tike: VSheU XENIX" . The 
default is VSheU. IF VSheU is set, the vsh form of commands given appear in the 
upward scrolling output window. If XENIX is specified, the XENIX command line 
which vsh generated will be shown instead. 

PermissionsOption 

The Permissions Option command allows changing the access permissions on files 
and directories. The functionality is the same as the chmod(C) command. Consult the 
chmod manual page if you do not understand the concept of XENIX permissions. 

In the name: field enter the name of the file or directory you wish to alter the 
permissions on. You may only alter the permissions on files and directories you own. 
Thereare four switches, who: , read: , write: , vatiexecute: . 

The who: switch has four settings, All , Me , Group and Others . All is the default. All 
refers to yourself, those with the same group id as yourself and others. Me refers to 
yourself. Grouprefersandallotherswithyourgroupid. Others refers tothose outside 
yourgroup. 

The read, write and execute switches have two settings, yes and no. The default is yes 
for Me, and no for GroupanAOthers . This grants the given type of permission to those 
specified in the who: switch. No takes away the given type of permission from those 
specified inthewho: switch. 



11.4.3 Print 

The Print command puts a file or files in the queue for your lineprinter. In the filename: 
option field , enter the file or files you want to print . 
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11.4.4 Quit 

The Quit command exits the Visual Shell. The only option is Enter Y to confirm: . 
Enter * Y ' or 'y ' ifyou really want toquit. Any other key cancels thequit. 

11.4.5 Run 

The Run command executes a program or shell script. The name: option takes the 
name of an executable file. In the parameters: option field enter flags to pass to the 
executable file. The output: option can specify a file to redirect output to or another 
program to send the output to. Enter a vertical bar T in the output field to use the pipe 
menu. 

It is also possible to run an executable file by highlighting the name of the file in the 
View Windowandpressing '- '. 

11.4.6 View 

The View command allows you to inspect without altering the contents of files and 
directories. View is also available at any time for an item highlighted in the View 
Window by pressing '='. See the section above labelled 'View Window* for the 
details of using View . 

To alter the height and characteristics of the View Window, use the 'Window' menu 
option . See the section below labelled ' ' Window" . 

Ifyou have invoked View from the menu, enter the name of the file or directory you 
wish to view in the VIEW name: field, or select from a directory view window. 

To return from any View action to the previously displayed View Window, press the 
minuskey'-'. 

If you View a non-executable binary file, non-asrii characters are displayed as the 
character 4 @\ 



11.4.7 Window 

The Window command alters the height and redraw characteristics of the Visual Shell 
View Window. . . ' 

The 

WINDOW redraw: Yes (No) 

switch turns onor off redraw of the view window after running a command . 

The height'valines: field changes the number of lines displayed in the view window. 
The minimum window height is 1 lines. The default window height is 5 lines. The 
maximum window height is 1 5 lines. 
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11.4.8 Pipes 



XENIX allows output from one program to be passed to another program or to be put in 
a tile. Thisiscalled 'piping' or 'pipelining*. Iftheoutputisplacedinafileitissaidtobe 
'redirected'. Piping is supported in the VisualShellthrough the pipe menu. 

The Pipe menu is invoked by entering a vertical bar 'I* character in any option field 
named output: For instance, the Run main menu and the Pipe menu itself have an 
output: field. The available Pipe menu commands are Count, Get, Head, More , Run, 
Sort a nd Tail . Each Pipe menu sub— command also has an output: field , which allows 
construction ofpipelinesofarbitrary length. 

11.4.9 Count 



Count counts words, lines and characters in the input pipe. The default is all of the 
above . There is a switch for each type of item to count. The Count Pipe Menu option 
corresponds to the XENIX command wc. Consult the manual page wc(C) for the 
functionality. 

11.4.10 Get 

Get looks for patterns in the input pipe. The pattern may be verbatim, or you may 
specify a "regular expression" to look for. Regular expressions may contain 
'wildcard' characters which represent sets of strings. Consult the manual page 
grep(C) for the available wildcard characters. 

The first Get switch is Unmatched (Yes) No . If you specify Yes (the default), all lines 
containing the given pattern will be output. If Unmatched is set to off, all lines not 
containing the given pattern will be out put. 

The second Get switch is ignore case: which suppresses the case while looking for the 
regular expression. The default is off. 

The third Get switch is line numbers: , which reports the line in the input stream which 
the regular expression was matched oa The default is on. 

11.4.11 Head 



Head prints a specified number of lines of the input stream starting from the first line. 
The lines: field may be set to specify the number of lines at the head of the input stream 
to print . The default is 5 lines . 

The Head Pipe Menu option corresponds to the XENIX command head. Consult the 
manual page head(C) for the functionality . 

11.4.12 More 

More allows viewing an input stream one screenatatime. The More PipeMenu option 
invokes the XENIX command more. Consult the manual page mbre(C) for the 
functionality. 
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11.4.13 Run 

The Run Pipe Menu option allows the specification of any command not in the Pipe 
menu. The functionality isthesameastheVisualShellMainMenu Option" Run". 

11.4.14 Sort 



The XENIX sort utility can be invoked through the Sort Pipe menu option. The input 
stream is sorted. 

The first Sort switch is order: < >. Select ' >" , the default, to sort in ascending order. 
Select '<* to sort in descending order . 

The second Sort switch suppresses the case of characters in the sort. The default isoff. 

ThethirdSort switch sortsthe input streamassuming an initial numeric field in the input 
stream. If this switch is off, initial numbers will be sorted in ascii Order, which means 
that a line beginning with '10' will be output before the line beginning with '2'. The 
default isoff. 

The fourth Sort switch sortsthe input streamindictionary order, rather than ascii order. 

The Sort Pipe Menu option corresponds to the XENIX command sort. Consult the 
manual page sort(C) for the functionality . 

11.4.15 Tall 



Tail prints a specified number of lines of the input stream up to the end of the stream. 
The lines: field may be set to specify the number of lines to print. The default is 15 
lines. 

The Tail Pipe Menu option corresponds to the XENIX command tail. Consult the 
manual page tafl(C) for the functionality . 
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Ed 



A.l Introduction 

Ed is a text editor used to create and modify text. The text is normally a 
document, a program, or data for a program, thus erf is a truly general purpose 
program. Note that the line editor ex, available with other XENIX packages is 
very similar to erf, and therefore this chapter can be used as an introduction to 
ex as well as to erf. 



A.2 Demonstration 

This section leads you through a simple session with erf, giving you a feel for 
how it is used and how it works. To begin the demonstration, invoke erf by 
typing: 

ed 

This invokes the editor and begins your editing session. An asterisk "*" 
prompts for commands to be entered. Initially, you are editing a temporary file 
that you can later copy to any file that you name. This temporary file is called 
the "editing buffer," because it acts as a buffer between the text you enter and 
the file that you will eventually write out your changes to. Typically, the first 
thing you will want to do with an empty buffer is add text to it. For example, 
after the prompt, type: 

a 

this is line 1 

this is line 2 

this is line 3 

this is line 4 

CNTRL-D 

This "appends" four lines of text to the buffer. To view these lines on your 
screen, type, 

Mp 

where the "1,4" specifies a line number range and the p command "prints" the 
specified lines on the screen. 

Now type 

2p 

to view line number two. Next type just 

P 
This prints out the current line on the screen, which happens to be line number 
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two. By default, most erf commands operate on only the current line. 

A.3 Basic Concepts 

This section illustrates some of the basic concepts that you need to understand 
to effectively use ed. 



A.3.1 The Editing Buffer 

Each time you invoke ed, an area in the memory of the computer is allocated on 
which you will perform all of your editing operations. This area is called the 
"editing buffer". When you edit a file, the file is copied into this buffer where 
you will work on the copy of the original file. Only when you write out your file 
do you affect the or iginal copy of the file. 



A. 3. 2 Commands 

Commands are entered by typing them at your keyboard. Like normal XENIX 
commands, entry of a command is ended by typing a NEWLINE. After you type 
NEWLINE the command is carried out. In the following examples, we will 
presume that entry of each command is completed by typing a NEWLINE, 
although this will not be explicitly shown in our examples. Most commands are 
single characters that can be preceded by the specification of a line number or a 
line number range. By default, most commands operate on the "current line", 
described below in the section on "Line Numbers". Many commands take 
filename or string arguments that are used by the command when it is 
executed. 



A.3. 3 Line Numbers 

Any time you execute a command that changes the number of lines in the 
editing buffer, ed immediately renumbers the lines. At all times, every line in 
the editing buffer has a line number. Many editing commands will take either 
single line numbers or line number ranges as prefixing arguments. These 
arguments will normally specify the actual lines in the editing buffer that are to 
be affected by the given command. By default, a special line number called 
"dot" specifies the current line. 



A.4 Tasks 

This section discusses the tasks you perform in everyday editing. Frequently 
used and essential tasks are discussed near the beginning of this section. 
Seldom-used and special-purpose commands are discussed later. 
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A. 4.1 Entering and Exiting The Editor 

The simplest way to invoke ed is to type: 

ed 
The most common way, however, is to type: 

ed filename 
where filename is the name of a new or existing file. 
To exit the editor, all you need to do is type: 

q 

If you have not yet written out the changes you have made to your file, ed warns 
you that you will lose these changes by printing the message: 



If you still want to quit, type another q. In most cases you will want to exit by 
typing: 

w 

q 

so that you first write outyour changes and only then exit the editor. 



A. 4. 2 Appending Text: a 

Suppose that you want to create some text starting from scratch. This section 
shows you how to put text in a file, just to get started. Later we'll talk about 
how to change it. 

When you first invoke ed, it is like working with a blank piece of paper — there 
is no text or information present. These must be supplied by the person using 
ed, usually by typing in the text, or by reading it in from a file. We will start by 
typing in some text and discuss how to read files later. 

In erf terminology, the text being worked on is said to be "kept in a buffer". 
Think of the buffer as a workspace, or simply as a place where the information 
that you are going to be editing is kept. In effect, the buffer is the piece of paper 
on which you will write things, make changes, and finally file away. 

You tell erfwhat to do to your text by typing instructions called "commands". 
Most commands consist of a single letter, each typed on a separate line. Ed 
prompts with an asterisk (*). This prompting can be turned on and off with the 
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prompt command, P. 

The first command we will discuss is append (a) written as the letter "a" on a 
line by itself. It means "append (or add) text lines to the buffer, as they are 
typed in." Appending is like writing new material on a piece of paper. 

To enter lines of text into the buffer, just type an "a", followed by a RETURN, 
followed by the lines of text you want, like this: 

a 

Now is the time 

for all good men 

to come to the aid of their party. 



To stop appending, type a line that contains only a period. The period ( . ) tells 
ed that you have finished appending. (You can also use CNTRL-D, but we will 
use the period throughout this discussion.) If erf seems to be ignoring you, type 
an extra line with just a period ( . ) on it. You may find you've added some 
garbage lines to your text, which you will have to take out later. 

After appending is completed, the buffer contains the following three lines: 

Now is the time 
for all good men 
to come to the aid of their party. 

The a and . aren't there, because they are not text. 

To add more text to what you already have, type another a command and 
continue typing your text. 

If you make an error in the commands you type to ed, it will tell you by 
displaying the message: 

error me ge age 



A.4.3 Writing Out a File: w 

You will probably want to save your text for later use. To write out the 
contents of the buffer into a file, use the write (w) command followed by the 
name of the file that you want to write to. This copies the contents of the buffer 
to the specified file, destroying any previous contents of the file. For example, 
to save the text in a file named text, type: 

w text 
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Leave a space between w and the filename. Ed responds by printing the 
number of characters it has written out. For instance, edmight respond with 

68 

(Remember that blanks and the newline character at the end of each line are 
included in the character count.) Writing out a file just makes a copy of the 
text — the buffer's contents are not disturbed, so you can go on adding text to it. 
If you invoked e d with the command "ed filename", then by default a w 
command by itself will write the buffer out to filename. 

This is an important point. Edzt all times works on a copy of a file, not the file 
itself. No change in the contents of a file takes place until you give a w 
command. Writing out the text to a file from time to time as it is being created 
is a good idea. If the system crashes or if you make some horrible mistake, you 
will lose all the text in the buffer, but any text that was written out to a file is 
relatively safe. 



A. 4. 4 Leaving The Editor: q 

To terminate a session with ed, save the text you're working on by writing it to 
a file using the w command, then type: 



The system responds with the XENIX prompt character. If you try to quit 
without writing out the file e d will print 



At that point, write out the text if you want to save it; if not, typing another 
"q" will get you out of the editor. 



Exercise 

Enter e rfand create some text by typing: 

a 

... text ... 

Write it out by typing: 

w filename 
Then leave edby typing: 
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Next, use the cat command to display the file on your terminal screen to see 
that every thing has worked. 



A.4.5 Editing A New File: e 

A common way to get text into your editing buffer is to read it in from a file. 
This is what you do to edit text that you have saved with the w command in a 
previous session. The edit ( e) command places the entire contents of a file in 
the buffer. If you had saved the three lines "Now is the time", etc., with a w 
command in anearlier session, the eicommand 

e text 

would place the entire contents of the file text into the buffer and respond with 



which is the number of characters in text. If anything is already in the buffer, it 
is dele ted first. 

If you use the e command to read a file into the buffer, then you don't need to 
use a filename after a subsequent w command. Ed remembers the last filename 
used in an e command, and w will write to this file. Thus, a good way to operate 
is this: 

ed 

e file 

[editing session] 

w 

q 

This way, you can type w from time to time and be secure in the knowledge that 
if you typed the filename right in the beginning, you are writing out to the 
proper file each time. 



A.4.6 Changing the File to Write Out to: f 

You can find out the last file written to at any time using the file (f) command. 
Just type f without a filename. You can also change the name of the 
remembered filename with f. Thus a useful sequence is 

ed precious 
f junk 

which gets a copy of the file named precious, then uses f to save the text in the 
file junk. The original file will be preserved as precious. 

A-6 



Ed 



A. 4.7 Reading in a File: r 

Sometimes you want to read a file into the buffer without destroying what is 
already there. This function is useful for combining files. This is done with the 
read (r) command. The command 

r text 

reads the file text into your editing buffer and adds it to the end of whatever is 
already in the buffer. For example, pretend that you have performed a read 
after an edit: 

e text 
r text 

The buffer now contains two copies of text (i.e., six lines): 

Now is the time 

for all good men 

to come to the aid of their party. 

Now is the time 

for all good men 

to come to the aid of their party. 

Like the w and e commands, after the reading operation is complete r prints 
the number of characters read in. 



Exercise 

Experiment with the e command by reading and printing various files. You 
may get the error message 



cannot open input file 

where name is the name of a nonexistent file. This means that the file doesn't 
exist, typically because you spelled the filename wrong, or perhaps because you 
do not have permission to read from or write to that file. Try alternately 
reading and appending to see how they work. Verify that the command 

ed file. text 

is equivalent to 

ed 

e file. text 
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A.4.8 Displaying Lines On The Screen: p 

Use the "print"( p) command to print the contents of the editing buffer (or 
parts of it) on the terminal screen. Specify the lines where you want printing to 
begin and where you want it to end, separated by a comma and followed by the 
letter "p". Thus, to print the first two lines of the buffer (that is, lines 1 through 
2) type: 

l,2p 

Ed responds with: 

Now is the time 
for all good men 

Suppose you want to print all the lines in the buffer. You could use "l,3p" as 
above if you knew there were exactly 3 lines in the buffer. But you will rarely 
know how many lines there are, so ed provides a shorthand symbol for the line 
number of the last line in the buffer — the dollar sign ($). Use it this way: 

l,tp 

This will print all the lines in the buffer (from line 1 to the last line). If you want 
to stop the printing before it is finished, press the INTERRUPT key. .Either) 
displays 



interrupt 
and waits for the next command. 
To print the laet line of the buffer, use: 

$p 
You can print any single line by typing the line number, followed by a p. Thus 

lp 
produces the response 

Now is the time 

which is the first line of the buffer. 

In fact, ed lets you abbreviate even further: you can print any single line by 
typing juet the line number; there's no need to type the letter p. If you type 
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$ 

ed prints the last line of the buffer. 

You can also use $ in combinations like 

$-l,$p 

which prints the last two lines of the buffer. This helps when you want to see 
how far you are in your typing. 

The next step is to use address arithmetic to combine the line numbers like dot 
(.) and dollar sign ($) with plus (+) and minus (-). (Note that "dot" is 
shorthand for the current line, and is discussed in a later section.) Thus 

$-1 

prints the next to last line of the current file (that is, one line before the line $). 
For example, to recall how far you were in a previous editing session 

$-5,$p 

prints the last six lines. (Be sure you understand why it's six, not five.) If there 
aren't six lines in the file, you'll get an error message. 

The command 

.-3,.+3p 

prints from three lines before the current line (line dot) to three lines after. The 
plus (+) can be omitted: 

.-3,.3p 

is identical in meaning. 

Another area in which you can save typing effort in specifying lines is to use plus 
and minus as line numbers by themselves. For example 



by itself is a command to move back one line in the file. In fact, you can string 
several minus signs together to move back that many lines. For example 



moves back three lines, as does 
-3 
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Thus 

-3,+3p 
is also identical to 

?.-3p+3p 

A.4.9 Displaying The Current Line: dot (.) 

Suppose your editing buffer still contains the following six lines: 

Now is the time 

for all good men 

to come to the aid of their party. 

Now is the time 

for all good men 

to come to the aid of their party. 

If you type 

l,3p 

erf displays 

Now is the time 
for all good men 
to come to the aid of their party. 

Try typing: 

P 

This prints 

to come to the aid of their party. 

which is the third line of the buffer. In fact, it is the last (most recent) line that 
you have done anything with. You can repeat this p command without line 
numbers, and c (/will continue to print line 3. 

This happens because ed maintains a record of the last line that you did 
anything to (in this case, line 3, which you just printed) so that it can be used 
instead of an explicit line number. The line most recently acted on is referred to 
with a period ( . ) and is called "dot". Dot is a line number in the same way that 
dollar ($) is; it means "the current line", or loosely, "the line you most recently 
did something to". You can use it in several ways. One possibility is to type: 
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.,lp 

This will print all the lines from (and including) the current line clear to the end 
of the buffer. In our example these are lines 3 through 6. 

Some commands change the value of dot, while others do not. The p command 
sets dot to the number of the last line printed. In the example above, p sets dot 
to 6. 

Dot is often used in combinations like this one: 

.+ 1 
Orequivalently: 

.+ lp 

This means "print the next line" and is one way of stepping slowly through the 
editing buffer. You can also type 

.-1 

This means "print the line before the current line". This enables you to go 
backwards through the file if you wish. Another useful command is something 
like 

.-3,.-lp 

which prints the previous three lines. 

Don't forget that all ofthttt change the value of dot. You can find out what dot 
is at any time by typing: 



Ed responds by printing the value of dot. Essentially, p can be preceded by 
zero, one, or two line numbers. If no line number is given, e rf prints the "current 
line", the line that dot refers to. If one line number is given (with or without the 
letter p), erf prints that line (and dot is set there); and if two line numbers are 
given, erf prints all the lines in that range (and sets dot to the last line printed). 



A-ll 



XENIX User's Guide 

If two line numbers are specified, the first cannot be bigger than the second. 
Pressing RETURN once causes printing of the next line. It is equivalent to: 

.+ lp 
Try it. Next, try typing a minus sign ( - ) by itself; it is equivalent to typing 

.-lp 

Exercise 

Create some text using the a command and experiment with the p command. 
You will find, for example, that you can't print line or aline beyond the end of 
the buffer, and that attempts to print lines in reverse order using "3,lp" do not 
work. 

A. 4. 10 Deleting Lines: d 

Suppose you want to get rid of the three extra lines in the buffer. Use the delete 
(d) command. Its action is similar to that of p, except that d deletes lines 
instead of printing them. The lines to be deleted are specified for d exactly as 
they are for p. Thus, the command 

4,$d 

deletes lines 4 through the end. There are now three lines left in our example, as 
you can check by typing: 

l,$p 

Notice that $ now is line 3! Dot is set to the next line after the last line deleted, 
unless the last line deleted is the last line in the buffer. In that case, dot is set to 



Exercise 

Experiment with the a, e, r, w, p, and d commands until you are sure that you 
know what they do, and until you understand how dot ( . ), dollar ($), and line 
numbers are used. 

Try using line numbers with a, r, and w, as well. You will find that a appends 
lines after the line number that you specify (rather than after dot); that r reads 
in a file after the line number you specify (not necessarily at the end of the 
buffer); and that w writes out exactly the lines you specify, not the whole buffer. 
These variations are sometimes useful. For instance, you can insert a file at the 
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beginning of a buffer by typing 

Or filename 
and you can enter lines at the beginning of the buffer by typing: 

Oa 

(t'npuf text here] 

Notice that typing 

.w 
is very different from typing 



since the former writes out only a single line and the latter writes out the whole 
file. 



A. 4. 11 Performing Text Substitutions: s 

One of the most important e (/commands is the substitute (s) command. This is 
the command that is used to change individual words or letters within a line or 
group of lines. It is the command used to correct spelling mistakes and typing 
errors. 

Suppose that, due to a typing error, line lsays: 

Now is th time 

The letter "e" has been left off of the word "the". You can uses to fix this up as 
follows: 

ls/th/the/ 

This substitutes for the characters "th", the characters "the", in line 1. To 
verify that the substitution has worked, type 

P 

to get 

Now is the time 

which is what you wanted. Notice that dot must be the line where the 
substitution took place, since the p command printed that line. Dot is always 
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set this way with the s command. 

The syntax for the substitute command follows: 

[et arting-lihe, ending-line]s/ patte rn/ replace me nt/ cmd$ 

Whatever string of characters is between the first pair of slashes is replaced by 
whatever is between the second pair, in all the lines between starting-line and 
ending-line. Only the first occurrence on each line is changed, however. 
Changing every occurrence is discussed later in this section. The rules for line 
numbers are the same as those for p, except that dot is set to the last line 
changed. (If no substitution takes place, dot is not changed. This causes 
printing of the error message: 

search string not found 
Thus, you can type 

1 ,$s/spe ling/spe lling/ 

and correct the first spelling mistake on each line in the text. 

If no line numbers are given, the s command assumes we mean "make the 
substitution on line dot", so it changes things only on the current line. This 
leads to the very common sequence 

s/something/something else/p 

which makes a correction on the current line, then prints it to make sure the 
correction worked out right. If it didn't, you can try again. (Notice that the p is 
on the same line as the s command. With few exceptions, p can follow any 
command; no other multicommand lines are legal.) 

It is also legal to type 

s/string// 

which means "change the first string of characters to nothing" or, in other 
words, remove them. This is useful for deleting extra words in a line or 
removing extra letters from words. For instance, if you had 

Nowxx is the time 
you could type 

s/xx//p 
to get 
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Now is the time 



Notice that two adjacent slashes mean "no characters", not a space. There i$ a 
difference. 



Exercise 

Experiment with the substitute command. See what happens if you substitute 
a word on a line with several occurrences of that word. For example, type: 

a 

the other side of the coin 

s/the/on the/p 

This results in: 

on the other side of the coin 

Asubstitute command changesonly the firet occurrence of the first string. You 
can change all occurrences by adding a g (for "global") to the s command, like 
this: 

s/.../.../g 

Try using characters other than slashes to delimit the two sets of characters in 
the s command — anything should work except spaces or tabs. 



A. 4. 12 Searching 

Now that you've mastered the substitute command, you can move on to 
mastering another important concept: context searching. 

Suppose you have the original three-line text in the buffer: 

Now is the time 
for all good men 
to come to the aid of their party. 

Suppose you want to find the line that contains the word "their", so that you 
can change it to the word "the". With only three lines in the buffer, it's pretty 
easy to keep track of which line the word "their" is on. But if the buffer 
contained several hundred lines, and you'd been making changes, deleting and 
rearranging lines, and so on, you would no longer really know what this line 
number would be. Context searching is simply a method of specifying the 
desired line, regardless of its number, by specifying a textual pattern contained 
in the line. 



A-15 



XENIX User's Guide 

The way to say "search for a line that contains this particular string of 
characters" is to type: 

/string of characters we want to find/ 

For example, the crfcommand 

/their/ 

is a context search sufficient to find the desired line — it will locate the next 
occurrence of the characters between the slashes (i.e., "their"). Note that you 
do not need to type the final slash. The above search command is the same as 
typing: 

/their 

The search command sets dot to the line on which the pattern is found and 
prints it for verification: 

to come to the aid of their party. 

"Next occurrence" means that erf starts looking for the string at line ".+1", 
searches to the end of the buffer, then continues at line 1 and searches to line 
dot. (That is, the search "wraps around" from $ to 1.) It scans all the lines in the 
buffer until it either finds the desired line or gets back to dot. If the given string 
of characters can't be found in any line, e (/prints the error message: 

search string not found 

Otherwise, erf prints the line it found. You can also search backwards in a file 
for search strings by using question marks instead of slashes. For example 

?thing? 

searches backwards in the file for the word "thing" as does 

?thing 

This is especially handy when you realize that the string you want is backwards 
from the current line. 

The slash and question mark are the only characters you can use to delimit a 
context search, though you can use any character in a substitute command. If 
you get unexpected results using any of the characters 

" ■ • $ [ * \ & 
read Section A.5, "Context and Regular Expressions". 
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You can do both the search for the desired line and a substitution at the same 
time, like this: 

/their/s/their/the/p 

Thisyields: 

to come to the aid of the party. 

The above command contains three separate actions. The first is a context 
search for the desired line, the second is the substitution, and the third is the 
printing of the line. 

The expression "/their/" is a context search expression. In their simplest form, 
all context search expressions are like this — a string of characters surrounded 
by slashes. Context searches are interchangeable with line numbers, so they 
can be used by themselves to find and print a desired line, or as line numbers for 
some other command, like s. They were used both ways in the previous 
examples. 

Suppose the buffer contains the three familiar lines 

Now is the time 
for all good men 
to come to the aid of their party. 

The erfline numbers 

/Now/+l 

/good/ 

/party/-l 

are all context search expressions, and they all refer to the same line (line 2). To 
make a change in line 2, you could type 

/Now/+ls/good/bad/ 
or 

/good/s/good/bad/ 
or 

/party /-ls/good/bad/ 
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The choice is dictated only by convenience. For instance, you could print all 
three lines by typing 



/Now/,/party/p 



/Now/,/Now/+2p 

or any similar combination. The first combination is better if you don't know 
how many lines are involved. 

The basic rule is that a context search expression is the same as a line number, 
so it can be used wherever a line number is needed. 

Suppose you search for 

/horrible thing/ 

and when the line is printed you discover that it isn't the "horrible thing" that 
you wanted, so it is necessary to repeat the search. You don't have to retype the 
search, because the construction 

// 

is a shorthand expression for "the previous thing that was searched for", 
whatever it was. This can be repeated as many times as necessary. You can also 
go backwards, since 



searches for the same thing, but in the reverse direction. 

You can also use / / as the left side of a substitute command, to mean "the most 
recent pattern". For example, examine: 

/horrible thing/ 

Ed prints the line containing " horrible thing" . 

s//good/p 

This changes "horrible thing" to "good". To go backwards and change 
"horrible thing" to "good", type: 

??s//good/ 
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Exercise 

Experiment with context searching. Scan through a body of text with several 
occurrences of the same string of characters using the same context search. 

Try using context searches as line numbers for the substitute, print, and delete 
commands. (Context searches can also be used with the r, w, and a 
commands.) 

Try context searching using Uextl instead of /text/ . This scans lines in the 
buffer in reverse order instead of normal order, which is sometimes useful if you 
go too far while looking for a string of characters. It's an easy way to back up in 
the file you're editing. 

If you get unexpected results with any of the characters 

* . • | • \ & 
read Section A. 4, "Context and Regular Expressions". 

A. 4. 13 Changing and Inserting Text: c and i 

This section discusses the change (c) command, which is used to change or 
replace one or more lines, and the insert (i) command, which is used for 
inserting one or more lines. 

The c command is used to replace a number of lines with different lines that you 
type at the terminal. For example, to change lines ".+1" through "$" to 
something else, type: 

•+l,$c 

type the lines of text you want here ... 



The lines you type between the c command and the dot ( . ) will replace the 
originally addressed lines. This is useful in replacing a line or several lines that 
have errors in them. 

If only one line is specified in the c command, then only that line is replaced. 
(You can type in as many replacement lines as you like.) Notice the use of a 
period to end the input. This works just like the period in the append command 
and must appear by itself on a new line. If no line number is given, the current 
line specified by dot is replaced. The value of dot is set to the last line you typed 
in. Note that the terminating period and the line referenced by dot are 
completely different: the first is used simply to terminate a command, the 
second points at a specific line of text. 
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The i command is similar to the append command. For example 



/string/i 

type the linee to be inserted here ... 



inserts the given text before the next line that contains "string". The text 
between i and the terminating period is inserted before the specified line. If no 
line number is specified, dot is used. Dot is set to the last line inserted. 



Exercise 

The c command is like a combination of delete followed by insert. Experiment 
to verify that 

start, end A 

i 

[text] 



is almost the same as 

start, endc 
[text] 



These are not precisely the same if the last line gets deleted. 

Experiment with a and i to see that they are similar, but not the same. Observe 
that 

line-numbers 
[text] 



appends after the given line, while 

line-number \ 
[text] 



inserts before it. If no line number is given, i inserts before line dot, while a 
appends after line dot. 



A.4.14 Moving Lines: m 

The move (m) command lets you move a group of lines from one place to 
another in the buffer. Suppose you want to put the first three lines of the buffer 
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at the end instead. You could do it by typing 

l,3w temp 
$r temp 
1,3d 

where temp is the name of a temporary file. However, you can do it more easily 
with the m command: 

l,3m$ 
This will move lines 1 through 3 to the end of the file. 
The general case is 

Btart-line,end-linemafter-tkie-Une 

There is a third line to be specified: the place where the moved text gets put. Of 
course, the lines to be moved can be specified by context searches. If you had 

First paragraph 

end of first paragraph. 

Second paragraph 

end of second paragraph. 

you could reverse the two paragraphs like this: 

/Second/,/end of second/m/First/-l 

Notice the -1. The moved text goes o/ferthe line mentioned. Dot gets set to the 
last line moved. Your file will now look like this: 

Second paragraph 

end of second paragraph 

First paragraph 

end of first paragraph 

As another example of a frequent operation, you can reverse the order of two 
adjacent lines by moving the first line after the second line. Suppose that you 
are positioned at the first line. Then 

m+ 

moves line dot "to one line after the current line dot. If you are positioned on the 
second line, 



moves line dot to one line after the current line dot. 
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The m command is more succinct than writing, deleting and rereading. The 
main difficulty with the m command is that if you use patterns to specify both 
the lines you are moving and the target, you have to take care to specify them 
properly, or you may not move the lines you want. The result of a bad m 
command can be a mess. Doing the job one step at a time makes it easier for you 
to verify at each step that you accomplished what you wanted. It is also a good 
idea to issue a w command before doing anything complicated; then if you 
make a mistake, it's easy to back up to where you were. 

For more information on moving text, see Section A.4.18, "Marking Your Spot 
inaFile:k". 



A.4.15 Performing Global Commands: g and v 

The "global" commands g and v are used to execute one or more editing 
commands on all lines that either contain (g) or don't contain (v) a specified 
pattern. 

For example, the command 

g/XENK/p 

prints all lines that contain the word "XENIX". The pattern that goes between 
the slashes can be anything that could be used in a line search or in a substitute 
command; exactly the same rules and limitations apply. 

For example, 

sA/p 

prints all the Preformatting commands in a file (lines that begin with "."). 
(For an explanation of the use of the caret (") and the backslash (\) see Section 
A.5, "Context and Regular Expressions". 

The v command is identical to g, except that it operates on those lines that do 
not contain an occurrence of the pattern. (Mnemonically, the "v" can be 
thought of as part of the word "inverse". 

For example 
v/VP 
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prints all the lines that don't begin with a period (i.e., the actual text lines). 

Any command can follow g or v. For example, the following command deletes 
all lines that begin with ".": 

g/'Y/d 

This command deletes all empty lines: 

Probably the most useful command that can follow a global command is the 
substitute command. For example, we could change the word "Xenix" to 
"XENIX" everywhere, and verify that it really worked, with 

g/Xenix/s//XENIX/gp 

Notice that we used //in the substitute command to mean "the previous 
pattern", in this case, "Xenix". The p command executes on each line that 
matches the pattern, not just on those in which a substitution took place. 

The global command makes two passes over the file. On the first pass, all lines 
that match the pattern are marked. On the second pass, each marked line is 
examined in turn, dot is set to that line, and the command executed. This 
means that it is possible for the command that follows a g or v command to use 
addresses, set dot, and so on, quite freely. For example: 

sA-P/+ 

prints the line that follows each ".P" command (the signal for a new paragraph 
in some formatting packages). Remember that plus (+) means "one line past 
dot". And 

g/topic/?-\.H?p 

searches for each line that contains the word "topic", scans backwards until it 
finds a line that begins with a ".H" (a heading) and prints it, thus showing the 
headings under which "topic" is mentioned. Finally 

g/-\.EQ/+,A.EN/-p 

prints all the lines that lie between lines beginning with ".EQ" and ".EN" 
formatting commands. 

The g and v commands can also be preceded by line numbers, in which case the 
lines sear ched are only those in the range specified. 

It is possible to give more than one command under the control of a global 
command. For example, suppose the task is to change "x" to "y" and "a" to 
"b" on all lines that contain "thing". Then 
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g/thing/s/x/y/\ 
s/a/b/ 

is sufficient. The backslash (\) signals the g command that the set of 
commands continues on the next line; the g command terminates on the first 
line that does not end with a backslash. 

Note that you cannot use a substitute command to insert a new line within a g 
command. Watch out for this. 

The command 

g/x/s//y/\ 
s/a/b/ 

does not work as you might expect. The remembered pattern is the last pattern 
that was actually executed, so sometimes it will be "x" (as expected), and 
sometimes it will be "a" (not expected). You must spell it out, like this: 

g/x/s/x/y/\ 
s/a/b/ 

It is also possible to execute a, c and i commands as part of a global command. 
As with other multiline constructions, add a backslash at the end of each line 
except the last. Thus, to add an ".nf" and ".sp" command before each ".EQ" 
line, type: 

g/ A \.EQ/i\ 

.nf\ 

.sp 

There is no need for a final line containing a period ( . ) to terminate the i 
command, unless there are further commands to be executed under the global 
command. 



A.4.16 Displaying Tabs and Control Characters: 1 

£rfprovides two commands for printing the contents of the text you are editing. 
You should already be familiar with p, in combinations like 

l,$p 

to print all the linesyou are editing, or 

s/abc/def/p 

to change "abc" to "def" on the current line. Less familiar is the "list" ( 1) 
command which gives slightly more information than p. In particular, 1 makes 
visible characters that are normally invisible, such as tabs and backspaces. If 
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you list a line that contains some of these, 1 prints each tab as ">" and each 
backspace as "<". This makes it much easier to correct the sort of typing 
mistake that inserts extra spaces adjacent to tabs, or inserts a backspace 
followed by a space. 

The 1 command also "folds" long lines for printing. Any line that exceeds 72 
characters is printed on multiple lines; each printed line except the last is 
terminated by a backslash ( \ ), so you can tell it was folded. This is useful for 
printing lines longer than the width of your terminal screen. 

Occasionally, the 1 command will print a string of numbers preceded by a 
backslash, such as \07 or \16. These combinations are used to make visible 
characters that normally don't print, like form feed, vertical tab, or bell. Each 
backslash-number combination represents a single ASCII character. Note that 
numbers are octal and not decimal. When you see such characters, be wary: 
they may have surprising meanings when printed on some terminals. Often 
their presence indicates an error in typing, because they are rarely used. 



A. 4. 17 Undoing Commands: u 

Occasionally you will make a substitution in a line, only to realize too late that 
it was a mistake. The undo (u) command, letsyou "undo" the last substitution. 
Thus the last line that was substituted can be restored to its previous state by 
typing: 



This command does not work with the g and v commands. 



A. 4. 18 Marking Your Spot in a File: k 

The mark command, k, provides a facility for marking aline with a particular 
name, so that you can later reference it by name, regardless of its actual line 
number. This can be handy for moving lines and keeping track of them as they 
move. For example 

kx 

marks the current line with the name "x". If aline number precedes the k, that 
line is marked. (The mark name must be a single lowercase letter.) You can 
refer to the marked line with the notation: 



Note the use of the single quotation mark ( ') here. Marks are very useful for 
moving things around. Find the first line of the block to be moved and then 
mark it with: 
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ka 
Then find the last line and mark it with 

kb 
Go to at the place where the text is to be inserted and type: 

'a, 'bm. 
Aline can have only one mark name associated with it at any given time. 



A. 4. 10 Transferring Lines: t 

We mentioned earlier the idea of saving lines that are hard to type or used 
often, to cut down on typing time. Ed provides another command, called t (for 
transfer) for making a copy of a group of one or more lines at any point. This is 
often easier than writing and reading. 

The t command is identical to the m command, except that instead of moving 
lines it simply duplicates them at the place you named. Thus 

l,$t$ 

duplicates the entire contents that you are editing. 

A common use for t is to create a series of lines that differ only slightly. For 
example, you can type 

a 

Now is the time for all good men to come to the aid of their party. 



t. 



make a copy] 
s/men/women/ [change it a bit] 

t. 
s/Now is/yesterday was/ 



make third copy] 
change it a bit] 



Your file will look like this: 



Now is the time for all good men to come to the aid of their party. 
Now is the time for all good women to come to the aid of their party. 
Yesterday was the time for all good women to come to the aid of their party. 



A.4.20 Escaping to the Shell: ! 

Sometimes it is convenient to temporarily escape from the editor to execute a 
XENIX command without leaving the editor. The shell escape (!) command, 
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provides a way to do this. 

If you type 

\command 

your current editing state is suspended, and the XENIX command you asked for 
is executed. When the command finishes, c d will signal you by printing another 
exclamation (!); at that pointyou can resume editing. 

A.5 Context and Regular Expressions 

You may have noticed that things don't work right when you use characters 
such as the period ( . ), the asterisk (*), and the dollar sign ($) in context searches 
and with the substitute command. The reason is rather complex, although the 
solution to the problem is simple. Ed treats these characters as special. For 
instance, in a context search or the first string of the substitute command, the 
period ( . ) means "any character", notaperiod, so 

A-y/ 

means a line with an "x", any character, and a "y", not just a line with an "x", a 
period, and a "y". A complete list of the special characters that can cause 
trouble follows: 

" • t I * \ / 

The next few subsections discuss how to use these characters to describe 
patterns of text in search and substitute commands. These patterns are called 
"regular expressions", and occur in several other important XENIX commands 
and utilities, including grep(C), ee d(C) (See the XENIX Reference Manned). 

Recall that a trailing g after a substitute command causes all occurrences to be 
changed. With 

s/this/that/ 

and 

s/this/that/g 

the first command replaces the first "this" on the line with "that". If there is 
more than one "this" on the line, the second form with the trailing g changes all 
of them. 

Either form of the s command can be followed by p or 1 to print or list the 
contents of the line. For example, all of the following are legal and mean 
slightly different things: 
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s/th is/that /p 
s/this/that/1 
s/this/that/gp 
s/this/that/gl 

Make sure you know what the differences are. 

Of course, any s command can be preceded by one or two line numbers to 
specify that the substitution is to take place on a group of lines. Thus 

l,$s/mispell/misspell/ 

changes the first occurrence of "mispell" to "misspell" in each line of the file. 
But 

l,$s/mispell/misspell/g 

changes every occurrence in each line (and this is more likely to be what you 
wanted). 

If you add a p or 1 to the end of any of these substitute commands, only the last 
line changed is printed, not all the lines. We will talk later about how to print 
all the lines that were modified. 



A.5.1 Period: (.) 

The first metacharacter that we will discuss is the period ( . ). On the left side of 
a substitute command, or in a search, a period stands for any single character. 
Thus the search 

A.y/ 

finds any line where "x" and "y" occur separated by a single character, as in 

x+y 
x-y 
x y 
xzy 

and so on. 

Since a period matches a single character, it gives you a way to deal with funny 
characters printed by 1. Suppose you have a line that appears as 

th\07is 

when printed with the 1 command, and that you want to get rid of the \07, 
which represents an ASCII bell character. 
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The most obvious solution is to try 

s/\07// 

but this will fail. Another solution is to retype the entire line. This is 
guaranteed, and is actually quite a reasonable tactic if the line in question isn't 
too big. But for a very long line, retyping is not the best solution. This is where 
the metacharacter "." comes in handy. Since \07 really represents a single 
character, if we type 

s/th. is/this/ 

the job is done. The period matches the mysterious character between the "h" 
and the "i", whatever it is. 

Since the period matches any single character, the command 

converts the first character on a line into a comma (,), which very often is not 
what you intended. The special meaning of the period can be removed by 
preceding it with a backslash. 

As is true of many characters in ed, the period (.) has several meanings, 
depending on its context. This line shows all three: 

.s/./7 

The first period is the line number of the line we are editing, which is called 
"dot". The second period is a metacharacter that matches any single character 
on that line. The third period is the only one that reaily is an honest, literal 
period. (Remember that a period is also used to terminate input from the a and 
i commands.) On the right side of a substitution, the period ( .) is not special. If 
you apply this command to the line 

Now is the time. 

the result is 

.ow is the time. 

which is probably not what you intended. To change the period at the end of 
the sentence to a comma, type 

s/V/,/ 

The special meaning of the period can be removed by preceding it with a 
backslash. 
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A.5.2 Backslash: \ 

Since a period means "any character", the question naturally arises: what do 
you do when you really want a period? For example, how do you convert the 
line 

Now is the time. 

into 

Now is the time? 

The backslash ( \ ) turns off any special meaning that the next character might 
have; in particular, "\." converts the "." from a "match anything" into a 
literal period, so you can use it to replace the period in "Now is the time." like 
this: 

■AW 

The pair of char acters "\." is considered by ed to be a single real period. 

The backslash can also be used when searching for lines that contain a special 
character. Suppose you are looking for a line that contains 

.DE 

at the start of aline. The search 

/.DE/ 

isn't adequate, for it will find lines like 

JADE 
FADE 
MADE 

because the "." matches the letter "A" on each of the lines in question. But if 
you type 

/\.DE/ 

only lines that contain "JDE" are found. 

The backslash can be used to turn off special meanings for characters other 
than the period. For example, consider finding a line that contains a backslash. 
The search 

A/ 
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won't work, because the backslash (\) isn't a literal backslash, but instead 
means that the second slash (/) no longer delimits the search. By preceding a 
backslash with another backslash, you can search for a literal backslash: 

AV 

You can search for a forward slash (/) with 

A// 

The backslash turns off the special meaning of the slash immediately following 
so that it doesn't terminate the slash-slash construction prematurely. 

A miscellaneous note about backslashes and special characters: you can use any 
character to delimit the pieces of an s command; there is nothing sacred about 
slashes. (But you must use slashes for context searching.) For instance, in a line 
that contains several slashes already, such as 

//exec //sys.fort.go // etc... 
you could use a colon as the delimiter. To delete all the slashes, type 

s:/::g 
The result is: 

exec sys.fort.go etc... 

When you are adding text with a or i or c, the backslash has no special meaning, 
and you should only put in one backslash for each one you want. 

Exercise 

Find two substitute commands, each of which converts the line 

\x\-\y 

into the line 

\x\y 

Here are several solutions; you should verify that each works: 

«A\V// 

s/x../x/ 

s/-y/y/ 
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A.5.3 Dollar Sign: $ 

The dollar sign "$", stands for "the end of the line". Suppose you have the line 

Now is the 

and you want to add the word "time" to the end. Use the dollar sign ($) like 
this: 

s/$/ time/ 
to get 

Now is the time 
A space is needed before "time" in the substitute command, or you will get: 

Now is the time 

You can replace the second comma in the following line with a period without 
altering the first. 

Now is the time, for all good men, 

The command needed is: 

«/,•/■/ 

to get 

Now is the time, for all good men. 

The dollar sign ($) here provides context to make specific which comma we 
mean. Without it the s command would operate on the first comma to produce: 

Now is the time, for all good men, 
To convert: , 

Now is the time, 
into 

Now is the time? 
as we did earlier, we can use: 

s/.$/?/ 
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Like the period ( . ), the dollar sign ($) has multiple meanings depending on 
context. In the following line 

$s/$/$/ 

the first "$" refers to the last line of the file, the second refers to the end of that 
line, and the third is a literal dollar sign to be added to that line. 



A.5.4 Caret: * 

The caret ( * ) stands for the beginning of the line. For example, suppose you 
are looking for a line that begins with "the". If you simply type 

/the/ 

you will probably find several lines that contain "the" in the middle before 
arriving at the one you want. But with 

/'the/ 

you narrow the context, and thus arrive at the desired line more easily. 

The other use of the caret ( * ) enables you to insert something at the beginning 
of a line. For example 

s/7/ 

places a space at the beginning of the current line. 

Metacharacters can be combined. To search for a line that contains only the 
characters 

P 

you can use the command 

r\n/ 

A. 5. 5 Star: * 

Suppose you have a line that looks like this: 

text x y text 

where "text" stands for lots of text, and there are an indeterminate number of 
spaces between the "x" and the "y". Suppose the job is to replace all the spaces 
between "x" and "y" with a single space. The line is too long to retype, and 



A-33 



XENIX User's Guide 

there are too many spaces to count. 

This is where the metacharacter "star" (*) comes in handy. A character 
followed by a star stands for as many consecutive occurrences of that character 
as possible. To refer to all the spaces at once, type: 

s/x *y/x y/ 

The " *" means "as many spaces as possible". Thus "x *y" means an "x", as 
many spaces as possible, then a "y". 

The star can be used with any character, not just a space. If the original 
example was 

text x y text 

then all minus signs (-) can be replaced by a single space with the command: 

s/x-*y/x y/ 
Finally, suppose that the line was: 

text x y text 

If you blindly type 

s/x.*y/x y/ 

The result is unpredictable. If there are no other x's or y's on the line, the 
substitution will work, but not necessarily. The period matches any single 
character so the ".*" matches as many single characters as possible, and unless 
you are careful, it can remove more of the line than you expected. For example, 
if the line was like this 

x text x y text y 

then typing 

s/x.*y/x y/ 

takes everything from the first "x" to the laet "y", which, in this example, is 
undoubtedly more than you wanted. 

The solution is to turn off the special meaning of the period (. ) with the 
backslash (\): 

s/x\.*y/xy/ 

Now the substitution works, for "\.*" means "as many periods as possible". 
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There are times when the pattern ".*" is exactly what you want. For example, 
to change 

Now is the time for all good men .... 
into 

Now is the time, 
use ".*" to remove everything after the "for": 

s/ for.*/-/ 

There are a couple of additional pitfalls associated with the star (*). Most 
notable is the fact that "as many as possible" means zeroor more. The fact that 
zero is a legitimate possibility is sometimes rather surprising. For example, if 
our line contained 

xy text x y text 

where the squares represent spaces, and we said 

s/x *y/x y/ 

the first "xy" matches this pattern, for it consists of an "x", zero spaces, and a 
"y". The result is that the substitute acts on the first "xy", and does not touch 
the later one that actually contains some intervening spaces. 

The way around this is to specify a pattern like 

/x *y/ 

which says an "x", a space, then as many more spaces as possible, then a"y", in 
other words, one or more spaces. 

The other pitfall associated with the star (*) again relates to the fact that zero is 
a legitimate number of occurrences of something followed by a star. The 
command 

s/ x */y/s 

when applied to the line 

abcdef 
produces 

yaybycydyeyfy 
which is almost certainly not what was intended. The reason for this is that 
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zero is a legitimate number of matches, and there are no x's at the beginning of 
the line (so that gets converted into a "y"), nor between the "a" and the "b" (so 
that gets converted into a"y"), and so on. If you don't want zero matches, use 

s/xx*/y/g 

since "xx*" is one or more x's. 



A. 5.6 Brackets: [ and ] 

Suppose that you want to delete any numbers that appear at the beginning of 
all lines of a file. You might try a series of commands like 

i,*/ A W/ 

l,$s/'3*// 

and so on, but this is clearly going to take forever if the numbers are at all long. 
Unless you want to repeat the commands over and over until finally all the 
numbers are gone, you must get all the digits on one pass. That is the purpose of 
the brackets. 

The construction 

[0123456789] 

matches any single digit — the whole thing is called a "character class". With a 
character class, the job is easy. The pattern "[0123456789]*" matches zero or 
more digits (an entire number), so 

l,$s/ A [0123456789]*// 

deletes all digits from the beginning of all lines. 

Any characters can appear within a character class, and there are only three 
special characters ( A , ], and -) inside the brackets; even the backslash doesn't 
have a special meaning. To search for special characters, for example, you can 
type: 

/I\ro/ 

It's a nuisance to have to spell out the digits, so you can abbreviate them as 
[0-9]; similarly, [a-z] stands for the lowercase letters, and [A-Z] for uppercase. 

Within [ ], the "[" is not special. To get a "]" (or a "-") into a character class, 
make it the first character. 

You can also specify a class that means "none of the following characters". 
This is done by beginning the class with a caret ( A ). For example 
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[-0-81 

stands for "any character except a digit". Thus, you might find the first line 
that doesn't begin with a tab or space with a search like: 

/T(space)(tab)j/ 

Within a character class, the caret has a special meaning only if it occurs at the 
beginning. Just to convince yourself, verify that 

finds a line that doesn't begin with a caret. 

A. 5. 7 Ampersand: & 

To save typing, the ampersand (&) can be used in substitutions to signify the 
string of text that was found on the left side of a substitute command. Suppose 
you have the line 

Now is the time 
and you want to make it: 

Now is the best time 
You can type: 

s/the/the best/ 

It's unnecessary to repeat the word "the". The ampersand (&) eliminates this 
repetition. On the right side of a substitution, the ampersand means "whatever 
was just matched", so you can type 

s/the/& best/ 

and the ampersand will stand for "the". This isn't much of a saving if the thing 
matched is just "the", but if the match is very long, or if it is something like 
".*" which matches a lot of text, you can save some tedious typing. There is 
also much less chance of making a typing error in the replacement text. For 
example, to put parentheses in a line, regardless of its length, type: 

The ampersand can occur more than once on the right side. For example 

s/the/& best and & worst/ 
makes 
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Now is the best and the worst time 
and 

s/.*/&? &!!/ 
converts the original line into 

Now is the time? Now is the time!! 

To get a literal ampersand use the backslash to turn off the special meaning. 
For example 

s/ampersand/\&/ 

converts the word into the symbol. The ampersand is not special on the left side 
of a substitute command, only on the right side. 

A. 5. 8 Substituting New Lines 

Ed provides a facility for splitting a single line into two or more shorter lines by 
"substituting in a newline". For example, suppose a line has become 
unmanageably long because of editing. If it looks like 

text xy text 

you can break it between the "x" and the "y" like this: 

s/xy/x\ 

y/ 

This is actually a single command, although it is typed on two lines. Because 
the backslash (\) turns off special meanings, a backslash at the end of a line 
makes the newline there no longer special. 

You can in fact make a single line into several lines with this same mechanism. 
As an example, consider italicizing the word "very" in a long line by splitting 
"very" onto a separate line, and preceding it with the formatting command 
"J". Assume the line in question looks like this: 

text a very big text 

The command 

s/ very /\ 

A 
very\ 
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converts the line into four shorter lines, preceding the word "very" with the 
line ".I", and eliminating the spaces around the "very" at the same time. 

When a new line is substituted in a string, dot is left at the last line created. 



A. 5.A Joining Lines 

Lines may be joined together, with the j command. Assume that you are given 
the lines: 

Now is 
the time 

Suppose that dot is set to the first line. Then the command 

j 

joins them together to produce: 

Now is the time 

No blanks are added, which is why a blank was shown at the beginning of the 
second line. 

All by itself, a j command joins the lines signified by dot and dot~+~l, but any 
contiguous set of lines can be joined. Just specify the starting and ending line 
numbers. For example, 

MJP 
joins all the lines in a file into one big line and prints it. 

A. 5. 10 Rearranging a Line: \( and \) 

Recall that "&" is shorthand for whatever was matched by the left side of an s 
command. In much the same way, you can capture separate pieces of what was 
matched. The only difference is that you have to specify on the left side just 
what pieces you're interested in. 

Suppose that you have a file of lines that consist of names in the form 

Smith, A B. 
Jones, C. 

and so on, and you want the initials to precede the name, as in: 
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A. B.Smith 
C. Jones 

It is possible to do this with a series of editing commands, but it is tedious and 
error-prone. 

The alternative is to "tag" the pieces of the pattern (in this case, the last name, 
and the initials), then rearrange the pieces. On the left side of a substitution, if 
part of the pattern is enclosed between \( and \), whatever matched that part is 
remembered, and available for use on the right side. On the right side, the 
symbol, "\1", refers to whatever matched the first \(...\) pair; "\2", to the 
second \(...\), and so on. 

The command 

i,W A \(M\). *\(-*\)/\2 W 

although hard to read, does the job. The first \(...\) matches the last name, 
which is any string up to the comma; this is referred to on the right side with 
"\1". The second \(...\) is whatever follows the comma and any spaces, and is 
referred to as "\2". 

With any editing sequence this complicated, it's unwise to simply run it and 
hope. The global commands g and v provide a way for you to print exactly 
those lines which were affected by the substitute command, and thus verify 
that it did what you wanted in all cases. 

A.6 Speeding Up Editing 

One of the most effective ways to speed up your editing is knowing what lines 
will be affected by acommand if you don't specify the lines it is to acton, and on 
what line you will be positioned (i.e., the value of dot) when a command finishes. 
If you can edit without specifying unnecessary line numbers, you can save a lot 
of typing. 

For example, if you issue a search command like 

/thing/ 

you are left pointing at the next line that contains "thing". Then no address is 
required with commands like s to make a substitution on that line, or p to print 
it, or 1 to list it, or d to delete it, or a to append text after it, or c to change it, or i 
to insert text before it. 

What happens if there is no occurrence of "thing"? Dot is unchanged. This is 
also true if the cursor was on the only occurrence of "thing" when you issued 
the command. The same rules hold for searches that use ?...?; the only 
difference is the direction in which you search. 
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The delete command, d, leaves dot pointing at the line that followed the last 
deleted line. When the line dollar ($) gets deleted, however, dot points at the 
new line $. 

The line-changing commands a, c, and i, by default, all affect the current line. 
If you give no line number with them, a appends text after the current line, c 
changes the current line, and i inserts text before the current line. 

The a, c, and i commands behave identically in one respect — when you stop 
appending, changing or inserting, dot points at the last line entered. This is 
exactly what you want when typing and editing on the fly. For example, you 
can type 

a 

text 

botch (minor error) 

s/botch/correct/ (fix botched line) 

a 

more text 



without specifying any line number for the substitute command or for the 
second append command. Or you can type: 

a 

text 

horrible botch (major error) 

c (replace entire line) 

fixed up line 



Experiment to determine what happens if you add no lines with an a, c, or i 
command. 

The r command reads a file into the text being edited, at the end if you give no 
address, or after the specified line if you do. In either case, dot points at the last 
line read in. Remember that you can even type 

Or 

to read a file in at the beginning of the text. (You can also type 0a or it to start 
adding text at the beginning.) 

The w command writes out the entire file. If you precede the command by one 
line number, that line is written out. If you precede it by two line numbers, that 
range of lines is written out. The w command does not change dot: the current 
line remains the same, regardless of what lines are written out. This is true even 
if you type something like 
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/ A \.AB/,/*\.AE/w abstract 

which involves a context search. 

(Since the w command is so easy to use, you should save what you are editing 
regularly as you go along just in case the system crashes, or in case you 
accidentally delete what you're editing.) 

The general rule is simple: you are left sitting on the last line changed; if there 
were no changes, then dot is unchanged. To illustrate, suppose that there are 
three lines in the buffer, and the line given by dot is the middle one: 

xl 
x2 

x3 

Then the command 

-,+s/x/y/p 

prints the third line, which is the last one changed. But if the three lines had 
been 

xl 

y2 
y3 

and the same command had been issued while dot pointed at the second line, 
only the first line would be changed and printed, and that is where dot would be 
set. 



A. 6.1 Semicolon: ; 

Searches with /.../ and ?...? start at the current line and move forward or 
backward, respectively, until they either find the pattern or get back to the 
current line. Sometimes this is not what you want. Suppose, for example, that 
the buffer contains lines like this: 
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ab 



be 



Starting at line 1, you would expect the command 

/a/./b/p 

to print all the lines from the "ab" to the "be" inclusive. This is not what 
happens. Both searches (for "a" and for "b") start from the same point, and 
thus they both find the line that contains "ab". As a result, a single line is 
printed. Worse, if there had been a line with a "b" in it before the "ab" line, 
then the print command would be in error, since the second line number would 
be less than the first, and it is illegal to try to print lines in reverse order. 

This is because the comma separator for line numbers doesn't set dot as each 
address is processed; each search starts from the same place. In ed, the 
semicolon (;) can be used just like the comma, with the single difference that use 
of a semicolon forces dot to be set at the time the semicolon is encountered, as 
the line numbers are being evaluated. In effect, the semicolon "moves" dot. 
Thus, in our example above, the command 

/a/;/b/p 

prints the range of lines from "ab" to "be", because after the "a" is found, dot 
is set to that line, and then "b" is searched for, starting beyond that line. 

This property is most often useful in a very simple situation. Suppose you want 
to find the aeeonrfoccurrence of "thing". You could type 

/thing/ 
// 

but this prints the first occurrence as well as the second, and is a nuisance when 
you know very well that it is only the second one you're interested in. The 
solution is to type: 

/thing/;// 

This says "find the first occurrence of "thing", set dot to that line, then find the 
second occurrence and print only that". 
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Closely related is searching for the second to last occurrence of something, as in: 

'something?;?? 

Finally, bear in mind that if you want to find the first occurrence of something 
in a file, starting at an arbitrary place within the file, it is notsufficient to type 

l;/thing/ 

because if "thing" occurs on line 1 it won't be found. The command 

0;/thing/ 

will work because it starts the search at line 1. This is one of the few places 
where is a legal line number. 

A.6.2 Interrupting the Editor 

As a final note on what dot gets set to, you should be aware that if you press the 
INTERRUPT key while ed is executing a command, your file is restored, as much 
as possible, to what it was before the command began. Naturally, some changes 
are irrevocable — if you are reading in or writing out a file, making 
substitutions, or deleting lines. These will be stopped in some unpredictable 
state in the middle (which is why it usually unwise to stop them). Dot may or 
may not be changed. 

If you are using the print command, dot is not changed until the printing is 
done. Thus, if you decide to print until you see an interesting line, and then 
press INTERRUPT, to stop the command, dot will not not be set to that line or 
even near it. Dot is left where it was when the p command was started. 

A.7 Cutting and Pasting with the Editor 

This section describes how to manipulate pieces of files, individual lines or 
groups of lines. 

A.7.1 Inserting One File Into Another 

Suppose you have a file called memo, and you want the file called table to be 
inserted just after a reference to Table 1. That is, in memo somewhere is aline 
that says 

Table 1 shows that ... 

and the data contained in table has to go there. 
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To put table into the correct place in the file edit memo, find "Table 1", and add 
the file table right there: 

ed memo 
/Table 1/ 
reeponee from ed 
.r table 

The critical line is the last one. The r command reads a file; here you asked for 
it to be read in right after line dot. An r command, without any address, adds 
lines at the end, so it is the same as "$r". 



A.7.2 Writing Out Part of a File 

The other side of the coin is writing out part of the document you're editing. 
For example, you may want to split the table from the previous example out 
into a separate file so it can be formatted and tested separately. Suppose that in 
the file being edited we have 

.TS 

[lots of stuff] 
.TE 

which is the way a table is set up for the tbl program. To isolate the table in a 
separate file called table, first find the start of the table (the ".TS" line), then 
write out the interesting part. For example, first type: 

/ATS/ 
This prints out the found line: 

.TS 
Next type 

,/*\.TE/w table 
andthejobisdone. If you are confident, you can do it all at once with 

/'\.TS/;/~\.TE/w table 

The point is that the w command can write out a group of lines, instead of the 
whole file. In fact, you can write out a single line if you like; just give one line 
number instead of two. If you have just typed a horribly complicated line and 
you know that it (or something like it) is going to be needed later, then save it — 
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don't retype it. For example, in the editor, type: 

a 

lots of stuff 

horrible line 

.w temp 

a 

more stuff 

.r temp 

a 

more stuff 



A.8 Editing Scripts 

If a fairly complicated set of editing operations is to be done on a whole set of 
files, the easiest thing to do is to make up a "script", i.e., a file that contains the 
operations you want to perform, then apply this script to each file in turn. 

For example, suppose you want to change every "Xenix" to "XENIX" and every 
"USA" to "America" in a large number of files. Put the following lines into the 
file script: 

g/Xenix/s//XENK/g 
g/USA/s//America/g 
w 

q 

Now you can type: 

ed - filel <script 
ed - file2 < script 



This causes ed to take its commands from the prepared file teript. Notice that 
the whole job has to be planned in advance, and that by using the XENIX shell 
command interpreter, you can cycle through a set of files automatically. The 
dash (-) suppresses unwanted messages from ed. 

When preparing editing scripts, you may need to place a period as the only 
character on a line to indicate termination of input from an a or i command. 
This is difficult to do in ed, because the period you type will terminate input 
rather than be inserted in the file. Using a backslash to escape the period won't 
work either. One solution is to create the script using a character such as the 
at-sign (@) to indicate end of input. Then, later, use the following command to 
replace the at-sign with a period: 
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A.9 Summary of Commands 

This following is a list of all ed commands. The general form of ed commands is 
the command name, preceded by one or two optional line numbers and, in the 
case of e, f, r, and w, followed by a filename. Only one command is allowed per 
line, but a p command may follow any other command (except e, f, r, w, and q). 

a Appends, i.e., adds lines to the buffer (at line dot, unless a different 
line is specified). Appending continues until a period is typed on anew 
line. The value of dot is set to the last line appended. 

c Changes the specified lines to the new text which follows. The new 
lines are terminated by a period on a new line, as with a. If no lines are 
specified, replace line dot. Dot is set to the last line changed. 

d Deletes the lines specified. If none are specified, deletes line dot. Dot is 
set to the first undeleted line following the deleted lines unless dollar 
($) is deleted, in which case dot is set to dollar. 

e Edits a new file. Any previous contents of the buffer are thrown away, 
so issue a w command first. 

f Prints the remembered filename. If a name follows f, then the 
remembered name is set to it. 

g The command g/ string /commands executes commands on those 
lines that contain string, which can beany context search expression. 

i Inserts lines before specified line (or dot) until a single period is typed 
on a new line. Dot is set to the last line inserted. 

1 Lists lines, making visible nonprinting ASCII characters and tabs. 

Otherwise similar to p. 

m Moves lines specified to after the line named after m. Dot is set to the 
last line moved. 

p Prints specified lines. If none are specified, print the line specified by 
dot. A single line number is equivalent to a line-numberp command. 
Asingle RETURN prints ".+1", the next line. 

q Quits ed. Your work is not saved unless you first give aw command. 
Give it twice in a row to abort edit. 

r Reads a file into buffer (at end unless specified elsewhere.) Dot is set to 
the last line read. 
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s The command "sf string l/string2/" substitutes the pattern matched 
by stringl with the string specified by string2'm the specified lines. If 
no lines are specified, the substitution takes place only on the line 
specified by dot. Dot is set to the last line in which a substitution took 
place; which means that if no substitution takes place, dot remains 
unchanged. The s command changes only the first occurrence of 
etringl on a line; to change multiple occurrences on a line, type a g 
after the final slash. 

t Transfers specified lines to the line named after t. Dot is set to the last 
line moved. 

v The command v/ string/ commands executes commands on those lines 
that do" not contain string. 

u Undoes the last substitute command. 

w Writes out the editing buffer to a file. Dot remains unchanged. 

.«■ Prints value of dot. (An equal sign by itself prints the value of $.) 

\command 

The line \cmd-line causes cmd-line to be executed as a XENIX 
command. 

/string/ 

Context search. Searches for next line which contains this string of 
characters and prints it. Dot is set to the line where string was found. 
The search starts at .+1, wraps around from $ to 1, and continues to 
dot, if necessary. 

tstringt 

Context search in reverse direction. Starts search at .-1 , scans to 1, 
wraps around to $. 
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asksubject option See Mail 
Asterisk («) 
BC 

comment convention 8- 

13 

comment convention 8- 

14 

multiplication operator 

symbol 8-2 

multiplication operator 

symbol 8-4 
directory name, use 
avoidance 7-3 
filename wildcard 3-7 
filename, use 
avoidance 3-4 
mail 

character matching 6-7 

message saved , header 
notation 6-16 
message saved, header 
notation 6-18 
metacharacter 7-3 
metacharacter 7-54 
pattern matching 
functions 3-7 
pattern matching See 
metacharacter 
special shell variable 7- 
18 
at command 4-22 
At sign (6), mail 6-30 
At sign (§), mail 6-39 
atrm command 4-23 
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auto command, BC 6-18 
autombox option See Nail 
autoprint option See Mail 
b command See Vi 
Background process 4-24 
$! variable 7-14 
ampersand (&) operator 4- 
24 

ampersand (&) operator 7- 
19 

ampersand (&) operator 7« 
54 

CNTRL-D immunity 7-19 
dial-up line 

CNTRL-D effect 7-19 
nohup command 7-19 
INTERRUPT immunity 7-19 
logout immunity 7-19 
QUIT immunity 7-19 
use restraint 7-19 
Backslash (\) 

escape character 2-4 
Backslash (\) 
BC 
comment convention 8« 
13 
Backslash (\) 
BC 
comment convention 8- 
14 
Backslash (\) 
BC 
line continuation 
notation 8-6 
Backslash (\) 

ed See Ed 
Backslash (\) 
erasing 2-4 



Backslash (\) 

line continuation 
notation 7-45 
Backslash (\) 

metacharacter escape 7-4 
Backslash (\) 

quoting 7-55 
BACKSPACE key 

erasure function 2-4 
inserting as text 2-4 
mail 6-11 
mail 6-6 
Batch processing See 

Command 
bcl command, BC 8-13 
be command 
BC 

file reading, 
execution 8-13 
invocation 8-1 
calculation 4-30 
BC 

addition operator 
evaluation order 8-15 
left to right binding 
8-4 

scale 8-17 
scale 8-6 
symbol (+) 8-4 
additive operators 
See also Specific 
Operator 

left to right binding 
8-17 
alphabetic register See 
storage register 
arctan function 
availability 8-1 
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loading procedure 8-13 

array 

auto array 8-18 
characteristics 8-14 
identifier 8-14 
identifier 8-19 
name 8-9 

named expression 8-15 
one-dimensional 8-9 

assignment operator 
designated, use 8-17 
evaluation order 8-15 
positioning effect 8-4 

symbol (=) 8-4 
assignment statement 8-12 

asterisk (») 

comment convention 8- 

13 

comment convention 8- 

14 

multiplication operator 

symbol 8-2 

multiplication operator 

symbol 8-4 
auto command 8-18 
auto statement 

built-in statement 8- 

19 
auto, keyword 8-14 
backslash (\) 

comment convention 8- 

13 
backslash (\) 

comment convention 8- 

14 



backslash (\) 

line continuation 

notation 8-6 
bases 8-5 
be -1 command 8-13 
be command 

file reading, 

execution 8-13 

invocation 8-1 
Bessel function 

availability 8-1 

loading procedure 8-13 

BKSP key 8-2 
braces ({}) 

compound statement 

enclosure 8-19 

function body 

enclosure 8-7 
brackets ([]) 

array identifier 8-14 

auto array 8-18 
subscripted variable 
8-9 
break statement 

built-in statement 8- 

19 
break, keyword 8-14 
built-in statement 8-19 
caret (*), exponentiation 
operator symbol 8-4 
command See be command 
comment convention 8-13 
comment convention 8-14 
compound statement 8-19 
constant 

composition 8-14 
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defined 8-15 
construction 

diagram 8-12 

space significance 8- 

12 
control statements 8-9 
cos function 

availability 8-1 

loading procedure 8-13 

define statement 

built-in statement 8- 

19 

description, use 8-20 
define, keyword 8-14 
demonstration run 8-1 
description 8-1 
division operator 

left to right binding 

8-16 

left to right binding 

8-4 

scale 8-17 

scale 8-6 

symbol (/) 8-4 
equal sign (=) 

assignment operator 

symbol 8-4 

relational operator 

8-18 

relational operator 

8-9 
equivalent constructions 
diagram 8-12 
evaluation sequence 8-2 
exclamation point (!) 

relational operator 

8-18 



relational operator 

8-9 
exit 8-1 
exit 8-3 
exponential function 

availability 8-1 

loading procedure 8-13 

exponentiation operator 

right to left binding 

8-17 

right to left binding 

8-4 

scale 8-17 

scale 8-6 

symbol C) 8-4 
expression 

enclosure 8-15 

evaluation order 8-14 

named expression 8-15 

statement 8-19 
for statement 

break statement effect 

8-19 

built-in statement 8- 

19 

description, use 8-9 

format 8-20 

range execution 8-10 

relational operator 

8-18 
for, keyword 8-14 
function call 

defined 8-15 

description 8-15 

evaluation order 8-15 

procedure 8-8 
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syntax 8-16 
function 

argument absence 8-8 

array 8-9 

calling See function 

call 

definition procedure 

8-7 

form 8-7 

identifier 8-14 

name 8-7 

parameters 8-8 

return statement See 

return statement 

termination, return 

statement 8-20 

variable automatic 8-7 

global storage class 8-18 

greater-than sign ( 

>), relational 

operator 8-18 

>), relational 

operator 8-9 
hexadecimal digit 

ibase 8-5 

obase 8-6 

value 8-14 
ibase 

decimal input setting 

8-5 

defined 8-15 

initial setting 8-5 

keyword 8-14 

named expression 8-15 

setting 8-5 



variable 8-7 
identifier 

array See array 

auto statement effect 

8-19 

description 8-14 

global 8-1 8 

local 8-18 

named expression 8-15 

value 8-18 
if statement 

built-in statement 8- 

19 

description, use 8-9 

format 8-20 

range execution 8-10 

relational operator 

8-18 
if, keyword 8-14 
INTERRUPT key 8-2 
introduction 8-1 
invocation 8-1 
keywords designated 8-14 
language features 8-12 
length 

built-in function 8-16 

keyword 8-14 
less-than sign (<), 
relational operator 8-18 
less-than sign (<), 
relational operator 8-9 
line continuation 
notation 8-6 
local storage class 8-18 
log function 

availability 8-1 
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loading procedure 8-13 

math function library See 
bcl command 
minus sign (-) 

subtraction operator 

symbol 8-4 

unary operator symbol 

8-16 

unary operator symbol 

8-4 
modulo operator 

left to right binding 

8-16 

left to right binding 

8-4 

scale 8-17 

scale 8-6 

symbol (%) 8-4 
multiplication operator 

evaluation order 8-15 

left to right binding 

8-16 

left to right binding 

8-4 

scale 8-1 6 

scale 8-6 

symbol (•) 8-2 

symbol (») 8-4 
multiplicative operators 

See also Specific 

Operator 

left to right binding 

8-16 
named expression 8-15 
negative number, unary 
minus sign (-) 8-4 



obase 

conversion speed 8-6 

defined 8-15 

description 8-5 

hexadecimal notation 

8-6 

initial setting 8-5 

keyword 8-14 

named expression 8-15 

variable 8-7 
operator 

See also Specific 

Operator 

designated, use 8-4 
parentheses (()) 

expression enclosure 

8-15 

function identifier 

argument enclosure 8- 

14 
percentage sign (%), 
modulo operator symbol 
8-4 
plus sign (+) 

addition operator 

symbol 8-4 

unary operator symbol 

8-16 
program flow alteration 
8-9 

quit command 8-1 
quit command 8-3 
quit statement 

BC exit 8-20 

built-in statement 8- 

1 9 
quit, keyword 8-14 
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quoted string statement 

8-19 

register See storage 

register 

relational operator 

designated 8-18 

designated 8-9 

evaluation order 8-15 
RETURN key 8-2 
return statement 

built-in statement 8- 

19 

description 8-20 

form 8-7 
return, keyword 8-14 
scale command 8-7 
scale 

addition operator 8-17 

addition operator 8-6 
arctan function 8-13 
Bessel function 8-13 
built-in function 8-16 

command See scale 

command 

cos function 8-13 

decimal digit value 

8-7 

defined 8-15 

description 8-6 

division operator 8-17 

division operator 8-6 
exponential function 
8-13 

exponentiation 
operator 8-17 



exponentiation 

operator 8-6 

initial setting 8-7 

keyword 8-14 

length function 8-16 

length maximum 8-6 

log function 8-13 

modulo operator 8-17 

modulo operator 8-6 

multiplication 

operator 8-16 

multiplication 

operator 8-6 

named expression 8-15 

sin function 8-13 

square root effect 8- 

16 

square root effect 8-6 

subtraction operator 

8-17 

subtraction operator 

8-6 

value printing 

procedure 8-7 

variable 8-7 
semicolon (;), statement 
separation 8-19 
semicolon (;), statement 
separation 8-3 
sin function 

availability 8-1 

loading procedure 8-13 

slash (/), division 
operator symbol 8-4 
space significance 8-12 
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square root 
built-in function 8-16 

keyword 8-14 

result as integer 8-5 

scale procedure 8-6 

sqrt keyword 8-14 
statement 

See also Specific 

Statement 

entry procedure 8-12 

execution sequence 8- 

19 

separation methods 8- 

19 

types designated 8-19 
storage classes 8-18 
storage register 8-4 
subscript 

fractions discarded 

8-9 

truncation 8-14 

value limits 8-9 
subscripted variable 

array See array 

description 8-9 

subscript See 

subscript 
subtraction operator 

left to right binding 

8-4 

scale 8-17 

scale 8-6 

symbol (-) 8-4 
syntax 8-1 

token composition 8-14 
truncation use when 8-7 



unary operator 
designated 8-16 
evaluation order 8-15 
left to right binding 
8-16 

symbol (-) 8-4 
variable 
automatic 8-18 
automatic 8-7 
name 8-7 
subscripted See 
subscripted variable 
while statement 

break statement effect 
8-19 

built-in statement 8- 
19 

description, use 8-9 
execution 8-21 
range execution 8-10 
relational operator 
8-18 
while, keyword 8-14 
Bessel function See BC 
Binary file See File 
Binary logical and 

operator 7-34 
Binary logical or 
operator 7-34 
BINUNIQ shell procedure 7- 

44 
BKSP key 
BC 8-2 

command-line buffer 
editing 3-9 
BKSP 

vi cursor movement 5-17 
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Block special device 4-16 
Bourne shell 

TERM variable 5-50 
terminal type 5-50 
Braces ({}) 
BC 

compound statement 

enclosure 8-19 

function body 

enclosure 8-7 
command grouping 7-25 
pipeline, command list 
enclosure 7-20 
variable 

conditional 

substitution 7-38 

enclosure 7-11 
Braces command ({}) 7-40 
Brackets ([]) 
BC 

array identifier 8-14 

auto array 8-18 

subscripted variable 

8-9 
directory name, use 
avoidance 7-3 
ed metacharacter See Ed 
filename, use 
avoidance 3-4 
metacharacter 7-3 
metacharacter 7-54 
pattern matching See 
metacharacter 
pattern-matching 
functions 3-8 
test command, use in lieu 
of 7-33 



break command 

for command control 7-24 

loop control 7-24 

shell built-in command 7- 

40 

special shell command 7-30 

while command control 7-24 

Buffer See Ed 
Buffers See Vi 5-23 
c command See Ed 
C language 
BC 

comment convention 
similarity 8-13 
syntax agreement 8-1 
shell language 7-1 
C shell 

TERM variable 5-50 
terminal type setting 5-50 

cal command 4-29 
Calculation 

See also BC 

example 4-30 
Calculator functions See 

BC 
calendar command 4-30 
Calendar reminder 

service 6-32 
Caret (*) 

BC, exponentiation 

operator symbol 8-4 

ed use See Ed 

mail, first message 

specification 6-15 
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mail, first message 

specification 6-34 

mail, first message 

specification 6-7 
case command 

description, use 7-22 

exit status 7-22 

redirection 7-26 

shell built-in command 7- 

40 
Case delimiter symbol 

(;;) 7-54 
Case significance 2-2 
Case-part 7-52 
cat command 

ed See Ed 

file 
combining 4-7 
contents display 2-3 
Cat 

command 4-7 
cd arg command 7-30 
cd command 4-15 

directory change 3-5 

directory change 7-14 

mail 6-22 

mail 6-34 

parentheses use 7-14 

time consumption 

minimization 7-42 
Changing password 4-2 
Changing terminal types 4-3 
Char acter class See Ed 
Character counting 4-22 
Character special 

device 4-16 
chmod command 4-17 



chmod command 4-19 
directory permission 
change 3-2 
file permission change 3-1 

chron option See Mail 
CNTRL-D 

background process 

immunity 7-19 

BC exit 8-2 

BC exit 8-3 

end-of-file 4-2 

logging out 2-5 

mail 4-28 
message sending 6-10 
message sending 6-3 
reply message 
termination 6-12 
reply message 
termination 6-19 

shell exit 6-21 

shell exit 7-25 

vi scroll 5-20 
CNTRL-F 

vi scroll 5-20 
CNTRL-G 

vi See Vi 5-11 
CNTRL-H, mail 6-6 
CNTRL-Q, output 

resumption 4-4 
CNTRL-S, output 

stopping 4-4 
CNTRL-U 

command-line buffer 

editing 3-9 

inserting as text 2-4 

kill character 2-4 
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line kill 4-4 

mail, line killing 6-11 

mail, line killing 6-6 

vi scroll 5-20 
Co command See Vi 
Colon (:) 

command See Colon command 

(:) 

mail 

command escape 6-26 
network mail 6-13 

PATH variable use 7-12 

variable conditional 

substitution 7-38 

vi use See Vi 
Colon command ( : ) 

description 7-30 

shell built-in command 7- 

40 

special shell command 7-30 

Command line 

ampersand (&) effect 3-9 
buffer defined 3-9 
defined 3-8 
entry 4-4 
erasure 4-4 
execution 7-18 
interpretation 3-9 
multiple commands 
entry 3-9 
options 

See also Specific 

Option 

designated 7-39 
pipeline, use in 7-20 
rescan 7-18 



RETURN key effect 4-4 

scanning sequence 7-18 

substitution 7-8 
Command list 

case command, 

execution 7-22 

defined 7-19 

for command, execution 7- 

23 

grammar 7-52 
Command 

See also Specific Command 

background submittal 3-9 
batch processing See 
background submittal 
dash (-) use 3-4 
defined 7-19 
delimiter See Ed 
directory See /bin 
directory 

directory See Directory 
ed commands See Ed 
enclosure in parentheses 
(()), effect 7-40 
environment 7-15 
execution 3-8 
execution 7-2 

RETURN key required 2-2 

sequence 4-24 

time 7-40 
exit status See Exit 
status 

grammar 7-52 
grouping 

exit status 7-26 
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parentheses (()) 

use 7-54 

procedure 7-25 

WRITEMAIL shell 

procedure 7-51 
keyword parameter 7-15 
line See Command line 
list See Command list 
lowercase letters 3-9 
mail commands summary 6-33 

multiple commands 
entry 3-9 
multiple commands 
entry 7-8 
name error 2-2 
output substitution 
symbol 7-54 

private command name 7-2 
program invocation 3-8 
public command name 7-2 
RETURN key required 2-2 
search 

PATH variable 7-12 

process 7-42 
separation symbol (;) 7-54 

shell, built-in commands 
designated 7-40 
simple command 

defined 7-19 

defined 7-2 

grammar 7-52 
slash (/) beginning, 
effect 7-2 

special shell commands See 
Shell 



special shell commands See 
Specific Special Command 
substitution 

back quotation marks 

<"> 7-4 

double quotation marks 

(\0 

procedure 7-8 

redirection 

argument 7-6 
syntax 3-9 
typing error 
correction 2-4 
vi commands See Vi 
Commands 
at 4-22 
atrm 4-23 
cal 4-29 
cat 4-7 
cd 4-15 
copy 4-14 
cp 4-8 
date 4-29 
diff 4-19 
diff3 4-20 
echo 4-20 
find 4-9 
head 4-6 
kill 4-26 
lc 4-11 
■ In 4-10 
lpr 4-27 
mkdir 4-13 
more 4-5 
mv 4-8 
passwd 4-2 
ps 4-24 
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pwd 4-14 

rm 4-9 

rmdir 4-13 

sort 4-20 

stty 4-4 

tail 4-6 

wc 4-22 
Communication See Mail 
Comparing files 4-19 
compose escapes 6-1 
Compose escapes See Mail 
Concatenate See cat 

command 
Console 2-2 
continue command 

for command control 7-24 

shell built-in command 7- 

40 

special shell command 7-30 

until command control 7-24 
while command control 7-24 

Control characters 

filename use 

restrictions 3-4 
Control command 

See also Specific Control 

Command 

redirection 7-26 
Copy command 4-14 
Copying a directory 4-14 
Copying files 4-8 
Copying See cp command 
COPYPAIRS shell 

procedure 7-44 



COPYTO shell procedure 7-45 
Counting, wc command 4-22 
cp command 4-8 
CR key See RETURN key 
Creating a directory 4-13 
Creating a file 4-5 
Current directory 

change 3-5 

procedure 4-14 

description 4-14 

printing 4-11 

shorthand name 3-6 

user residence 3-6 
Current line 

See Vi 
Cursor movement 

vi See Vi 
Cutting and pasting 

procedure See Ed 
D command See Vi 
d command 

ed use See Ed 

mail, message deletion See 

Mail 
d$ command See Vi 
dO command See Vi 
Dash (-), permission 

denial notation 4-16 

ordinary file notation 4- 

16 
Dash (-) 

command option use 3-4 

filename, use 

avoidance 3-4 

switch use 3-9 
date command 2-2 
Date command 4-29 
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dd command See Vi 
Delete buffer See Vi 
Deleting a file 4-9 
Deletion See d command 
Deletion 

vi procedure See Vi 
Delimiter See Ed 
Demonstration 2-1 
Device special file See 

Special file 
Device 

filename 3-4 

filenamerequired 3-4 

pathname 3-4 
Diagnostic output See 

Output 
Dial-up line See Background 

process 
Diff command 4-19 
diff3 4-20 
Digit grammar 7-52 
Directory 

/bin See /bin directory 

/dev See /dev directory 

/lib See /lib directory 

/tmp directory 4-25 

/tmp See /tmp directory 

/tty See /tty directory 

/usr See /usr directory 

access permission See 

Permission 

changing 4-14 

command See cd command 

composition 3-2 

copying 4-14 

creating 4-13 

current directory See 

Current directory 



description 3-2 
diagram 3-3 
file See File 
filename 

required 3-4 

unique to directory 3-4 

listing 4-12 

columns 4-11 
logging in result 3-2 
long listing 4-12 
name, metacharacter 
avoidance 7-3 
nesting 3-2 
parent directory See 
Parent directory 
pathname required 3-4 
permission notation 4-16 
permission See Permission 

protection 3-2 

recursive listing 4-12 

removing 4-13 

renaming 4-13 

search permission See 

Permission 

search 

optimum order 7-42 
PATH variable 7-42 
sequence change 7-3 
size effect 7-43 
time consumption 7-42 

size consideration 7-43 

user control 3-2 

working directory See 

Current directory 
Displaying a file 4-5 
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DISTINCT 1 shell 

procedure 7-45 
Division See BC 
Division See Calculation 
Dollar sign ($) 

ed use See Ed 

mail, final message 

specification 6-15 

mail, final message 

specification 6-34 

mail, final message 

specification 6-7 

positional parameter 

prefix 7-10 

positional parameter 

prefix 7-11 

PS1 variable default 

value 7-13 

variable prefix 7-11 

vi See Vi 
Dot (.) 

command See Dot command 

(.) 

ed use See Ed 

mail, current message 

specification 6-15 

mail, current message 

specification 6-7 

vi use See Vi 
Dot command ( . ) 

description, use 7-27 

shell built-in command 7- 

40 

shell procedure 

alternate 7-32 

special shell command 7-30 



Dot option See Mail 
Double quotation marks See 
Quotation marks, double 
(\0 
dp command See Mail 
DRAFT shell procedure 7-46 
dw command See Vi 
dw command See Vi 5-27 
e command 

ed use See Ed 
mail 6-34 
mail 6-7 
mailR 6-21 
echo command 2-3 
echo command 4-20 
-n option effect 7-35 
description, use 7-35 
mail 6-34 
syntax 7-35 
Ed 

a command 
append A-3 
append A-48 
backslash (\) 
characteristics A-32 
dot (.) setting A-41 
dot (.) setting A-48 
global combination A-24 

input termination A-30 
input termination A-4 
abortion, q command A-48 
address arithmetic A-9 
ampersand (&) 
literal A-38 
metacharacter A-38 
substitution A-38 
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append See a command 
asterisk (*), 
metacharacter A-27 
asterisk (*), 
metacharacter A-3 1 * 
at sign (§), script A-U7 
backslash (\) 

a command A-32 
backslash (\) 

c command A-32 
backslash (\) 

g command A-24 
backslash (\) 

i command A-32 
backslash (\) 

line folding A-25 
backslash (\) 

literal A-31 
backslash (\) 

metacharacter A-27 
backslash (\) 

metacharacter A-30 
backslash (\) 

metacharacter 

escape A-30 
backslash (\) 

metacharacter 

escape A-31 
backslash (\) 

metacharacter 

escape A-38 
backslash (\) 

metacharacter 

escape A-39 
backslash (V) 

multiline 

construction A-24 



backslash (\) 

number string A-25 

backslash (\) 
v command A-24 

backspace printing A-25 

brackets ([]) 

character class A-37 
metacharacter A-27 
metacharacter A-36 

buffer 

description A-4 
writing to file See w 
command 

c command 

backslash (\) 
characteristics A-32 
dot (•) setting A-20 
dot (.) setting A-i»1 
dot (.) setting A-M8 
global combination A-2U 

input termination A-20 

line change A-19 

line change A-U8 
caret O 

character class A-37 

line beginning 

notation A-33 

metacharacter A-27 

met ac har ac ter A-3 3 
cat command A-6 
change command See c 
command 

character class A-37 
character 

deletion at line 

beginning A-36 



1-18 



command 

See also Specific 

Command 

combinations A -24 

delimiter character A- 

31 

description A-4 

editing command See e 

command 

form A-4 8 

INTERRUPT key 

effect A-45 

listing A-48 

multicommand line 

restrictions A-15 

summary A-H8 
context search See search 

current line See dot (.) 
cutting and pasting 

move command See m 

command 

procedures A-45 
d command 

deletion A-12 

deletion A-48 

dot (.) setting A-41 

dot (.) setting A-48 
deletion See d command 
delimiter 

character choice A-31 
description A-1 
dollar sign ($) 

last line notation A-12 

last line notation A-33 



last line notation A-8 
line end notation A-32 
line end notation A-33 
metacharacter A-27 
metacharacter A-32 
multiple functions A-33 

dot (.) 

current line 

notation A-9 

description A-11 

determination A-41 

search setting A-1 6 

search setting A-49 

substitution 

setting A-1 4 

symbol ( . ) A-1 1 

symbol (.) A-30 

value determination A- 

12 

value determination A- 

49 
duplication See t command 

e command A-48 
e command A-6 
edit See e command 
entry A-3 
equals sign ( = ) 

dot value printing 

(. = ) A-12 

dot value printing 

(. = ) A-49 

last line value 

printing A-49 
escape command (!) A-27 
escape command (!) A-49 
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exclamation point (!), 
escape command A -27 
exit See q command 
f command A-48 
f command A-7 
file 

insertion into another 

file A-45 

writing out A-45 
filename 

change A-7 

recovery A-7 

remembered filename 

printing A-48 

remembered filename 

printing A-7 
folding A-25 
g command 

a command 

combination A-24 

backslash (\) use A-24 

c command 

combination A-24 

command 

combinations A-23 

command 

combinations A-24 

dot (.) setting A-23 

i command 

combination A-24 

line number 

specifications A-24 

multiline 

construction A-24 

s command 

combination A-23 

s command 

combination A-49 



search, command 
execution A-22 
search, command 
execution A-48 
substitution A-15 
substitution A-28 
trailing g A-28 

global command See g 

command 

global command See v 

command 

greater -than sign (>), tab 
notation 
A-25 

grep command A-28 

hyphen (-), character 

class A-37 

i command 
backslash (\) 
characteristics A-32 
dot (.) setting A-20 
dot (.) setting A-41 
dot (.) setting A-48 
global combination A-24 

input termination A-30 
insertion A-19 
insertion A-48 
in-line input scripts 7-47 

input 

termination A-20 

termination A-30 

termination A-4 
insert command See i 
command 
INTERRUPT key 

command execution 
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effect A-45 

dot (.) setting A-45 

print stopping A-8 

introduction A-1 

invocation A-3 

j command, line 

joining A-39 

k command, line 

marking A-25 

1 command 

folding A-25 
line listing A-25 
line listing A-48 
nondisplay character 
printing A-25 
number string A-25 
s command 
combination A-28 

less-than sign (<) 

backspace notation A-25 

line beginning 

character deletion A-36 

notation A-33 
line end 

notation A-32 
line number 

as line number A-44 

combinations A-9 

summary A-48 
line 

beginning See line 

beginning 

break See splitting 

folding A-25 

joining A-39 



marking A-26 
moving See m command 
number See line number 

rearrangement A-40 
splitting A-39 
writing out A-46 

list See 1 command 

m command 

dot (.) setting A-22 
dot (.) setting A-48 
line moving A-21 
line moving A-48 
warning A-22 

mail system See Mail 

marking See k command 

metacharacter 

ampersand (&) A-38 
asterisk («) A-27 
asterisk («) A-34 
backslash (\) A-27 
backslash (\) A-30 
brackets ([]) A-27 
brackets ([]) A-36 
caret O A-27 
caret C) A-33 
character class A-37 
combination A-34 
dollar sign ($) A-27 
dollar sign ($) A-32 
escape A-31 
escape A-38 
period (.) A-27 
period (.) A-29 
search A-37 
slash (/) A-27 
star («) A-27 
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star («) A-3M 
minus sign (-) , address 
arithmetic A-9 
move 

command See m command 

line marking A-26 
multicommand line 
restrictions A-15 
new line 

substitution A-39 
nondisplay character 
printing A -25 
p command 

dot (.) setting A-45 

multicommand line A-15 

printing A-M8 

printing A-8 

s command 

combination A-28 
pattern search See search 

per iod ( . ) 
a command input 
termination A-30 
a command input 
termination A-4 
c command input 
termination A-20 
char acter 

substitution A-29 
dot symbol See Dot (.) 

i command input 
termination A-30 
literal A-30 
metacharacter A-27 



metacharacter A-29 
s command , effect A-29 
script problems A-47 
search problems A-27 
troff command 
prefix A-23 

plus sign (+), address 

arithmetic A-9 

print 

command See p command 

line folding A-25 

RETURN key effect A-12 

stopping A-8 
q command 

abortion use A-48 

quit session A -4 8 

quit session A-5 

w command 

combination A-48 
question mark (?) 

exit warning A-3 

search error message 

(?) A-16 

search repetition 

(??) A-18 

search, reverse 

direction (? ?) A-17 

search, reverse 

direction (? ?) A-M9 

write warning A-5 
quit See q command 
quotation marks, single 

(") 

line marking A-26 
r command 

dot (.) setting A-42 
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dot (.) setting A-48 

file insertion A-45 

positioning without 

address A-45 

read file A-48 

read file A-7 
reading See r command 
regular expression 

description A-28 

metacharacter list A-27 

RETURN key, printing A-48 
s command 

ampersand (&) A -38 

character match A-29 

description, use A-13 

description, use A-49 

dot (.) setting A-14 

dot (.) setting A-41 

dot (.) setting A-49 

g command 

combination A-15 

g command 

combination A-23 

g command 

combination A -49 

1 command 

combination A-28 

line number A-28 

new line A -39 

p command 

combination A-28 

search combination A-17 

text removal A-15 
trailing g A-28 
undoing A-25 



v command 

combination A-23 
script A-47 
search 

dot (.) setting A-49 

error message (?) A-16 

forward search (/ 

/) A-16 

forward search (/ 

/) A-49 

global search See g 

command 

global search See v 

command 

metacharacter 

problems A-27 

next occurrence 

description A-16 

procedure A-16 

repetition (//), 

(??) A-18 

reverse direction (? 

?) A-17 

separator A-43 

substitution 

combination A-17 
sed command A-28 
semicolon (;) 

dot ( . ) setting A-44 

search separator A-43 
shell 

escape See escape 

command ( ! ) 
slash (/) 

delimiter A-31 

literal A-31 

metacharacter A-27 
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search forward (/ 

/) A-16 

search forward (/ 

/) A-49 

search repetition 

(.//> A-18 
special character See 
metacharacter 
spelling correction See s 
command 
star (•), 

metacharacter A -27 
star (•), 

metacharacter A— 3 1 * 
substitution 

command See s command 

t command 
dot (.) setting A-49 
transfer line A -26 
transfer line A-49 

tab printing A-25 

tbl command A-46 

termination See q command 

text 
removal See s command 

saving A-5 
transfer See t command 
troff command printing A- 
23 

typing error correction 
See s command 
u command 

undo A-25 

undo A-49 



undo See u command 
v command 

a command 

combination A-24 

backslash (\) use A-24 

c command 

combination A-24 

command 

combinations A-23 

command 

combinations A-24 

dot (.) setting A-23 

global search, 

substitute A-22 

global search, 

substitute A-49 

i command 

combination A -24 

line number 

specifications A-24 

s command 

combination A-23 
w command 

description, use A-5 

dot (.) setting A-42 

dot (.) setting A-49 

e command 

combination A-48 

file write out A-45 

frequent use 

advantages A-42 

line write out A-46 

write out A-45 

write out A-49 

write out A-5 
write out 

command See w command 
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warning A-5 
EDFIND shell procedure 7-47 
Editor See Ed 
EDITOR string, mail 6-29 
EDITOR string, mail 6-39 
EDLAST shell procedure 7-47 
egrep See grep command 
elif clause See if command 
else clause See if command 
Else-part grammar 7-52 
Empty grammar 7-52 
ENTER key See RETURN key 
Equal sign (=) 
BC 

assignment operator 

symbol 8-4 

relational operator 

8-18 

relational operator 

8-9 
ed use See Ed 
mail, message number 
printing 6-16 
mail , message number 
printing 6-34 
variable 
conditional 
substitution 7-38 
string value 
assignment 7-10 
errdirect file 7-28 
Error output 

redirection 7-37 
ESCAPE key 
vi See Vi 
Escape string, mail 6-29 
Escape string, mail 6-39 



eval command 

command line rescan 7-18 
shell built-in command 7- 
40 
Ex, ed similarity A-1 
Exclamation point (!) 
BC, relational operator 
8-18 

BC, relational operator 
8-9 

ed use See Ed 
mail 

network mail 6-13 
shell command 
execution 6-21 
shell command 
execution 6-25 
shell command 
execution 6-34 
unary negation 
operator 7-34 
vi See Vi 
exec arg command 7-30 
exec command 7-40 
Exit code See $? variable 
exit command 

shell built-in command 7- 

40 

shell exit 7-25 

special shell command 7-30 

Exit status 

$? variable 7-13 
case command 7-22 
cd arg command 7-30 
colon command (:) 7-30 
command grouping 7-26 
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false command 7-36 

if command 7-21 

read command 7-30 

true command 7-36 

until command 7-23 

wait command 7-31 

while command 7-23 
Exponentiation See BC 
Exponentiation See 

Calculation 
export command 

shell built-in command 7- 

40 

variable 
example 7-13 
listing 7-16 
setting 7-15 
expr command 7-35 
F command, mail 6-12 
F command, mail 6-20 
F command, mail 6-35 
f command 

ed use See Ed 

mail 6-11 

mail 6-12 

mail 6-19 

mail 6-35 
false command 7-36 
fgrep See grep command 
f i command 

if command end 7-21 

mail 6-35 
File descriptor 

description, use 7-5 

redirection 7-37 

redirection 7-6 
File permission 

changing 4-17 



File permissions, 

listing 4-12 
File system 
defined 3-3 
diagram 3-4 
organization 3-3 
File 
access 

control 3-1 

last access time 3-1 

permission See 

Permission 
addition See creation 
alphabetizing See sort 
appending 4-7 
attributes 3-1 
binary file 3-1 
combining 4-7 
composition 3-1 
copying 4-8 
creating 4-5 

with vi 5-2 
creation 

MKFILES shell 

procedure 7-49 

permission See 

Permission 

time 3-1 

write permission 

control 3-2 
defined 3-1 
deleting 4-9 
deletion 

write permission 

control 3-2 
descriptor See File 
descriptor 



1-26 



directory See Directory 

displaying 4-5 

displaying 4-6 

displaying 4-7 

editing See Vi 

filename See Filename 

grammar 7-52 

inode number See Inode 

number 

linking 4-10 

listing 3-2 

mail system files See 

Mail 

manipulation 4-4 

modification time 3-1 

moving 4-7 

moving 4-8 

name See Filename 

paginating 4-27 

pathname required 3-4 

pathname, printing 4-14 

pattern search See Ed 

pattern search See grep 

command 

pattern search See Pattern 

matching facility 

permission See Permission 

permissions 4-15 

pipe interchange 7-46 

printing See Linepr inter 

protection 3-1 

removal 4-9 

renaming 4-8 

scratch file directory 3-6 

shell procedure 
creation 7-31 



size in bytes 3-1 

sorting 4-20 

special file See Special 

file 

temporary file See 

Temporary file 

textual contents 

determination 7-51 

types designated 3-1 

variable file creation See 

Variable 
Filename 

argument 7-3 

asterisk («) wildcard 3-7 

characters use 

restrictions 3-4 

description 3-4 

ed See Ed 

example designated 3-6 

long listing 4-12 

question mark (?) 

representation 3-8 

required 3-1 

required 3-4 

unique to directory 3-4 
Files 

comparing 4-19 
Filter 

description 7-7 

order consideration 7-41 
find command 4-9 
Finding a file 4-9 
finger command 4-25 
Flag See Option 
fmt command, mail 6-25 
for command 

break command effect 7-24 
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continue command 

effect 7-24 

description, use 7-23 

redirection 7-26 

shell built-in command 7- 

40 
for loop, argument 

processing 7-17 
Foreground process 4-24 
fork command 7-40 
FSPLIT shell procedure 7-48 
Full pathname See Pathname 
g command See Ed 
G command 

vi See Vi 
Global 

ed use See Ed 

variable check 7-33 
goto command 

See G command 5-5 
Greater-than sign ( 

)>BC, relational 
operator 8-18 
)>BC, relational 
operator 8-9 
)>file combination 4-7 
) >output 

redirection 3-11 
)>PS2 variable default 
value 7-13 
) Redirection 
symbol 2-3 
) Redirection 
symbol 7-54 
grep command 4-21 
ed See Ed 



Group permission See 

Permission 
h command 

mail 6-16 

mail 6-35 

mail 6-9 

vi use See Vi 
H flag, mail 6-17 
head command 4-6 
headers command See Mail 
ho command See Mail 
Home directory 4-15 
HOME variable 

conditional 

substitution 7-39 

description 7-12 
i command See Ed 
if command 

COPYTO shell procedure 7- 

45 

description, use 7-20 

exit status 7-21 

fi command required 7-21 

multiple testing 

procedure 7-21 

nesting 7-21 

redirection 7-26 

shell built-in command 7- 

40 

test command 7-33 
IFS variable 7-12 
ignore option See Mail 
ignorecase option See 

Vi 5-36 
In-line input document See 

Input 
Inode number 

defined 3-2 
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link See Link 

Is command 3-2 

required for file 3-1 

required for file 3-2 
Input 

ed See Ed 

grammar 7-52 

in-line input 
document 7-36 
EDFIND shell 
procedure 7-47 

keyboard origin 3-10 

redirection See 

Redirection 

standard input file 7-5 

termination 4-2 
Insert mode See Vi 
Insertion See Ed 
Internal field separator 

shell scanning 

sequence 7-18 

specificaiton by IFS 

variable 7-12 
INTERRUPT key 

background process 

immunity 7-19 

BC 8-2 

command-line buffer 

cancellation 3-9 

ed use See Ed 

foreground process 

killing 4-24 

logging in, nonsense 

character removal 2-1 

mail 

askcc switch 6-27 
message abortion 6-11 



message abortion 6-28 

program stopping 2-5 
Interrupt 

handling methods 7-27 

key See INTERRUPT key 
Invocation flag See Option 
Item grammar 7-52 
j command See Ed 
j command 

vi use See Vi 
k command See Ed 
k command 

vi use See Vi 
Keyword parameter 

-k option effect 7-33 

description 7-15 
Kill character See CNTRL-U 
kill command 4-24 
kill command 4-26 
Killing a process 4-24 
1 command 4-12 

ed use See Ed 

mail 6-19 

mail 6-35 

vi use See Vi 
lc command 4-11 

listing 2-3 
Less-than sign (<) 

BC, relational operator 

8-18 

BC, relational operator 

8-9 

redirection symbol 7-54 
Less-than symbol (<) 

input redirection 3-12 
line command 

shell variable value 

assignment 7-9 
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Line-oriented commands See 

Vi 5-12 
Line 

beginning See Ed 

counting See wc command 

writing out See Ed 
linen umber option See Vi 
Line printer 

command See lpr command 

file printing 4-27 

queue information 4-26 

queue information 4-27 
Link 

command See In command 

defined 3-2 

description 4-10 

long listing 4-12 
Linking files 4-10 
list command 

mail 6-35 
list option See Vi 
LISTFIELDS shell 

procedure 7-49 
Listing directory 

contents 4-1 1 
Listing See 1 command 
Listing See 1c command 
In command 4-10 
Logging in 4-1 

nonsense character 

removal 2-1 

procedure 2-1 

prompt character 2-1 

resetting terminal 

charchter istics 2-4 

type-ahead not allowed 2-4 



Logging out 

background process 

immunity 7-19 

procedure 2-5 

procedure 4-2 

shell termination 7-25 
Login directory 

defined 7-12 

new user 2-1 
Login message 2-1 
Login 

procedure 4-1 
Looping 

break command 7-24 

continue command 7-24 

control 7-24 

expr command 7-36 

false command 7-36 

for command 7-23 

iteration counting 

procedure 7-36 

time consumption 7-40 

true command 7-36 

unconditional loop 

implementation 7-36 

until command 7-23 

while command 7-22 

while loop 7-44 
lpr command 

file printing 4-27 

mail 

-m option 6-32 
message printing 6-19 
message printing 6-35 

pipe 4-27 

pr command combination 4* 

27 
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Is command 

echo * use in lieu of 7-35 

function 3-2 
inode number use 3-2 
m command 
ed See Ed 
mail 6-19 
mail 6-35 
M flag See Mail 
magic option See Vi 
mail command See Mail 
MAIL variable 7-12 
Mail 

-b option 6-31 
-c option 6-31 
-R option 6-31 
-u option 6-31 
-f option 6-31 
-f option 6-9 
-i option 6-30 
-i option 6-31 
-i option 6-39 
-i option 6-9 
-m option 6-32 
-s option M-28 
-s option 6-31 
.mailrc file 

alias contents 6-20 

distribution list 

creation 6-13 

example 6-27 

options setting 6-13 

set command 6-20 

unset command 6-20 
? command See help command 
(?) 



a command See alias 
accumulation 6-32 
Alias 6-34 
alias 

a command 6-13 

a command 6-20 

a command 6-3** 

display 6-13 

network mail 6-13 

personal 6-13 

personal 6-27 

R command 6-13 

system-wide 6-27 
askcc option 6-13 
askcc option 6-27 
askcc option 6-39 
asksubject option 6-27 
asksubject option 6-39 
asterisk (*) 

character matching 6-7 

message saved , header 

notation 6-16 

message saved , header 

notation 6—18 
at sign (§), ignore switch 
echo 6-30 

at sign (§) , ignore switch 
echo 6-39 
autombox option 

description, use 6-30 

description, use 6-39 

effect 6-18 

H flag 6-17 

ho command 6-19 
autoprint option 6-28 
autoprint option 6-39 
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BACKSPACE key 6-11 

BACKSPACE key 6-6 

Bcc field See blind carbon 

copy field 

blind carbon copy field 

description 6-5 

editing 6-23 

editing 6-24 

escape See bcc escape 

box See Mailbox 
carbon copy field 

additions prompt 6-13 

blind See blind carbon 

copy field 

description 6-5 

display 6-4 

editing 6-24 

escape See c escape 

escape See cc escape 

option See askcc 

option 

R command effect 6-12 
caret (*), first message 
specification 6-15 
caret (*), first message 
specification 6-34 
caret (*), first message 
specification 6-7 
cc field See carbon copy 
field 

cd command 6-22 
cd command 6-34 
chron option 6-28 
chron option 6-39 
CNTRL-D 

message reply 6-12 



message reply 6-19 
message sending 6-10 
CNTRL-H, backspace 6-6 
CNTRL-U, line killing 6-11 

CNTRL-U, line killing 6-6 
colon (:) 

escape See command 

escape ( :) 

network mail 6-13 
command escape ( :) 6-26 
command escape ( :) 6-37 
command line options 6-31 
command mode 

description, use 6-7 

help command 6-14 

options setting 6-13 
command 

See also Specific 

Command 

descriptions 6-14 

escape See command 

escape ( :) 

invocation 6-14 

mail command See mail 

command 

summary 6-33 

syntax 6-8 
compose escape ( !) 6-37 
compose escape ( !) 6-37 
compose escapes 

See also Specific 

Escape 

compose mode exit 6-6 

edit mode entry 6-7 

head ing escapes 6-23 

listing 6-11 
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listing 6-2 

in command 6-19 

reply 6-19 

summary 6-37 

tilde ( ) component 6- 

11 
compose mode 

compose escapes See 

compose escapes 

description, use 6-6 

edit mode entry 6-7 

entry from command 

mode 6-1 1 

entry from shell 6-11 

tilde escapes See 

compose escapes 
concepts 6-4 
d command 4-28 
d command 6-11 
d command 6-17 
d command 6-34 
d command 6-4 
d command 6-7 
dead. letter file 

escape See d escape 

no save switch 

effect 6-28 

undelivered message 

receipt 6-10 
deletion See message 
distribution list 
creation 6-12 
dollar sign ($), final 
message specification 6-15 

dollar sign ($), final 
message specification 6-34 



dollar sign ($), final 

message specification 6-7 

dot (.), current message 

specification 6-15 

dot (.), current message 

specification 6-7 

dot option 6-28 

dot option 6-39 

dp command 6-17 

dp command 6-34 

e command 6-21 

e command 6-34 

echo command 6-34 

editor escape See e 

escape 

editor escape See v 

escape 

EDITOR string 6-29 

EDITOR string 6-39 

entry 6-9 

equal sign (=), message 

number printing 6-16 

equal sign (=), message 

number printing 6-34 

escape string 6-29 

escape string 6-39 

exclamation point (!) 

network mail 6-13 

shell command 

execution 6-21 

shell command 

execution 6-25 

shell command 

execution 6-34 
exit 

q command 4-28 

q command 6-17 
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q command 6-36 

q command 6-4 

q command 6-9 

x command 6-18 

x command 6-34 
f command 6-11 
f command 6-12 
f command 6-19 
F command 6-20 
f command 6-35 
fi command 6-35 
file switch See -f option 

files designated 6-33 
forwarding 

messages not 

deleted 6-17 

procedure See F 

command 
h command 6-16 
h command 6-35 
h command 6-9 
H flag i message saving 6- 
17 
header 

characteristics 6-16 

command See h command 

defined 6-6 

display 6-3 

display 6-8 

display 6-9 

listing 6-35 

windows 6-16 

windows 6-8 
heading 

compose escapes 6-23 

composition 6-5 



help command (?) 6-14 
help command (?) 6-3 
help escape ( ?) 6-11 
help escape ( ?) 6-22 
help escape ( ?) 6-37 
ho command 

description 6-19 

H flag 6-17 

message saving 6-35 
hold command See ho 
command 

ignore switch See -i 
option 
INTERRUPT key 

message abortion 6-11 

message abortion 6-28 

recipient list 6-27 
introduction 6-1 
invocation, -i option 6-9 
1 command 6-19 
1 command 6-35 
line killing 6-11 
line killing 6-6 
list command 6-35 
lpr command 

-m option 6-32 

message printing 6-19 

message printing 6-35 
m command 6-19 
m command 6-35 
M flag, message saving 6- 
17 
mail command 

command mode entry 6-7 

command mode entry 6-9 
compose mode entry 6-11 
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help 6-3 

message reading 6-10 

message reading 6-3 

message sending 6-2 

message sending 6-35 
mail escapes See M 
escape 

mailbox See Mailbox 
mb command 6-18 
mb command 6-35 
mbox command See mb 
command 

mchron option 6-39 
message number 

command 6-1 6 

command 6-34 

message printing 6-10 

printing 6-16 

printing 6-34 

types 6-7 
message-list 

argument, multiple 

messages 6-12 

composition 6-7 

full message-list 

description 6-8 
message 

abortion 6-11 

abortion 6-28 

abortion 6-9 

advancement 6-10 

advancement 6-34 

body 6-6 

composition 6-5 

deletion 4-28 

deletion 6-11 

deletion 6-17 



deletion 6-34 

deletion 6-4 

deletion 6-7 

deletion undoing 6-17 

description 6-5 

display 4-28 

editing 6-11 

editing 6-21 

editing 6-31 

editing 6-34 

file inclusion 6-24 

forwarding See 

forwarding 

header See header 

heading See heading 

insertion into new 

message 6-25 

list See message-list 

listing 6-3 

number See message 

number 

printing See printing 

range description 6-7 

reading 6-10 

reading 6-3 

reading into file 6-9 

reply See reply 

saving See saving 

sending See sending 

size 6-21 

size 6-36 

specification 6-12 

undeletion 6-1 1 
metacharacters 6-15 
metacharacters 6-7 
me too option 6-28 
metoo option 6-39 
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minus sign (-), message 
advancement 6-34 
network mail 6-13 
noisy phone line 6-9 
nosave option 6-28 
nosave option 6-39 
number command See message 
number 
options 

See also Specific 

Option 

command line 

options 6-31 

setting 6-13 

summary 6-39 

switch option 

setting 6-20 
organization 6-32 
p command 

message printing 6-14 

message printing 6-36 

message printing 6-4 

message printing 6-7 

syntax 6-8 
page option 6-29 
per iod ( . ) , dot use See 
dot (.) 

phone line noise 6-9 
plus sign (+)• message 
advancement 6-34 
printing 

command See lpr 

command 

command See p command 

escape See p escape 

linepr inter See lpr 

command 



procedure 6-10 

procedure 6-7 

top five lines See t 

command 
programs designated 6-33 
prompt 4-28 
prompt 6-3 
q command 

exit 4-28 

exit 6-17 

exit 6-36 

exit 6-4 

exit 6-9 

message abortion 6-28 
question mark (?) 

command summary 

printing 6-34 

compose escape help See 

help escape ( ?) 

help command 6-14 
quiet option 6-28 
quiet option 6-40 
R command 

alias effect 6-13 
r command 

compose, mode entry 6-11 

message reply 6-11 
R command 

message reply 6-12 
r command 

message reply 6-19 

message reply 6-36 

read escape See d escape 

read escape See r escape 



1-36 



reading 4-28 
recipient list, name 
addition 6-23 
record string 6-29 
record string 6-40 
reminder service 4-30 
reminder service 6-32 
Reply command See R 
command 

return receipt request 
field 6-5 
s command 

flag 6-16 

message saving 6-18 

message saving 6-36 

system mailbox, message 

deletion 6-17 
saving 

asterisk (») 

notation 6-18 

automatic 6-17 

command See s command 

flag 6-16 

ho command 6-35 

M flag 6-17 

message display 6-4 

s command 6-18 

s command 6-36 

system mailbox 6-9 

w command 6-18 

w command 6-37 
se command See set 
command 
sending 4-27 

cancellation 

impossible 6-3 

multiple recipients 6- 

10 



network mail 6-13 

procedure 6-10 

to self 6-2 
session abortion 6-11 
set command 

description, use 6-20 

description, use 6-36 

option control 6-39 
set options defined 6-27 
sh command 6-21 
sh command 6-36 
shell commands 6-21 
shell escape ( t) 6-25 
shell escape (!) 6-25 
SHELL string 6-29 
SHELL string 6-40 
si command 6-21 
si command 6-36 
so command 6-22 
so command 6-36 
source command See so 
command 

special characters See 
metacharacters 
startup file 6-27 
string option 

setting 6-20 

summary 6-39 
subject escape See s 
escape 

subject field 6^4 
subject field 6-5 
subject switch See -s 
option 

subject switch See 
asksubject option 
switch See Option 
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system composition 6-33 
system mailbox, message 
retention 6-9 
t command 

message top 

printing 6-12 

message top 

printing 6-16 

message top 

printing 6-36 

toplines option 6-16 
tilde escapes See compose 
escapes 

tilde quote escape 
( ) 6-26 

tilde quote escape 
( ) 6-37 
to field 

mandatory 6-5 

R command effect 6-12 
top command See t command 

toplines option 6-40 

toplines string 6-30 

u command 6-11 

u command 6-17 

u command 6-36 

u command 6-7 

undeletion See u command 

unset command 
description, use 6-20 
description, use 6-37 
option control 6-39 

v command 6-21 

v command 6-37 

v command 6-7 

variable See MAIL 

variable 



vertical bar (S) escape 
See shell escape ( S) 
VISUAL string 6-29 
VISUAL string 6-40 
w command 
message write out 6-18 

message write out 6-37 
system mailbox, message 
deletion 6-17 
write escape See w 
escape 

write out See w command 
x command 
exit 6-18 
exit 6-34 

session abortion 6-11 
you have mail message 2-1 

! See shell escape ( !) 

: See command escape 
( :> 

? See help escape ( ?) 

b escape 6-23 

bcc escape 6-38 

c escape 6-23 

cc escape 6-38 

d escape 6-24 

dead escape 6-38 

e escape 6-23 

editor escape 6-38 

h escape 6-24 

headers escape 6-38 

M escape 6-25 

message escape 6-38 

p escape 6-22 

print escape 6*38 

quit escape 6-38 
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r escape 6-24 
read escape 6-38 
s escape 6-23 
subject escape 6-38 
t escape 6-23 
to escape 6-38 
v escape 6-23 
visual escape 6-38 
w escape 6-25 
write escape 6-38 
! See shell escape ( !) 
See tilde quote escape 
( ) 
Mailbox 
cleaning out 6-32 
command 6-18 
reading in 6-9 
system mailbox 6-5 
user mailbox 
filename 6-5 
message saving 
notation 6-17 
Make directory See mkdir 

command 
Marking See Ed 
mb command See Mail 
mbox command See Mail 
mchron option 

mail 6-39 
mesg option See Vi 
Metacharacter 

asterisk («) 7-54 
brackets (.[]) 7-54 
directory name use 
avoidance 7-3 
escape 7-4 
list designated 7-54 



mail 6-15 

mail 6-7 

question mark (?) 7-54 

redirection 

restriction 7-6 
metoo option See Mail 
Minus sign (-) 

BC 

subtraction operator 

symbol 8-4 

unary operator symbol 

8-16 

unary operator symbol 

8-4 

mail, message 

advancement 6-34 

redirection effect 7-36 

subtraction operator 

symbol 8-4 

variable conditional 

substitution 7-38 
mkdir command 4-13 
MKFILES shell procedure 7- 

49 
more command 4-5 
Move See mv command 
Multiple way branch See case 

command 
Multiplication See BC 
mv command 4-7 
mv command 4-8 

directory moving 4-13 
n command See Vi 
Name grammar 7-52 
Name special file 4-16 
Named pipe 4-16 
newgrp command 

description 7-30 
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shell built-in command 7- 

40 

special shell command 7-30 

Newline substitution See 

Ed 
next command See Vi 5-44 
nohup command 7-19 
no save option See Nail 
nu command See Vi 5-24 
Null command See Colon 

command (: ) 
NULL shell procedure 7-50 
Number sign (#), comment 

symbol 7-54 
Operator See BC 
Option 

See also Specific Option 

configuration 3-9 

DRAFT shell procedure 7-46 

grouping 3-9 
invocation flags 7-39 
mail options See Mail 
multiple options 

grouping See grouping 

separate listing 3-10 

position 3-9 

tr ac i ng , $- v ar i abl e 7 - 1 4 
Options 

terminal 4-4 

vi options See Vi 
Or-if operator ( j !) 

command list 7-19 

description* use 7-20 

designated 7-54 



Ordinary file See File 
Output 

append symbol ( 

»» 7-5 

»» 7-54 
appending 

procedure 3-11 

symbol (»») 3-11 
control 4-4 
creation symbol ( 

» 7-54 
diagnostic output file 7-5 

error redirection 7-37 

grammar 7-52 

redirection 2-3 

redirection 4-7 

redirection See 

Redirection 

resumption 4-4 

standard error file See 

diagnostic output file 

standard output file 7-5 

terminal screen 

destination 3-10 

to file 2-3 
p command 

ed use See Ed 

mail 
message printing 6-14 
message printing 6-36 
message printing 6-4 
message printing 6-7 
syntax 6-8 
page option See Mail 
Parent directory 

description 3-6 
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shorthand name 3-6 
Parentheses (()) 
BC 

expression enclosure 

8-15 

function identifier 

argument enclosure 8- 

14 
command grouping 7-25 
command grouping 7-40 
command grouping 7-54 
pipeline, command list 
enclosure 7-20 
test command operator 7-34 

passwd command 4-2 
Password 
changing 4-2 
logging in 2-1 
new user 2-1 
PATH variable 
conditional 
substitution 7-39 
description 7-12 
directory search 

effect 7-42 

sequence change 7-3 
Pathname 
absolute pathname 

example 3-5 

required 3-4 

slash (/) 

significance 3-5 

unique to system 3-4 
defined 3-5 

full pathname See absolute 
pathname 



relative pathname 
defined 3-5 
example designated 3-6 

structure 3-5 
Pattern matching facility 

cancellation 3-8 

case command 7-22 

characters 3-7 

description 3-6 

expr command argument 

effect 7-35 

grep command 4-21 

limitations 7-3 

metacharacter See 

Metacharacter 

redirection 

restriction 7-6 

shell function 7-3 

variable assignment, not 

applicable 7-11 
Pattern 

grammar 7-52 

metacharacter 7-54 
Percentage sign (%), BC 

modulo operator symbol 

8-4 
Period (.) 

ed use See Ed 

filename use 3-4 

pattern matching facility 

restrictions 7-3 

vi See Vi 

working directory 

change 4-15 
Permission types 4-16 
Permission 

block special device 

notation 4-16 
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change 3-2 

denial notation 4-16 

directory permission 

assignment 3-2 

change 3-2 

change 4—17 

combinations 

designated 4-17 

file creation, deletion 

notation 4-16 

file listing 

notation 4-16 

notation 4-1 6 

search notation 4-16 

search permission 4-19 

write permission 3-2 
execute notation 4-16 
file permission 

change 3-1 

denial notation 4-16 

execute permission 4-16 

file creation, deletion 

notation 4-16 

file listing 

notation 4-16 

file protection 3-1 

notation 4-16 

read notation 4-16 

required 3-1 

write notation 4-16 
listing 4-15 
notation 4-16 
read notation 4-16 
search notation 4-16 
symbols designated 4-16 
user class 
specification 4-18 



write notation 4-16 
PHONE shell procedure 7-50 
PID 

$! variable 7-14 

$$ variable 7-13 
process identification 
number 4-24 
process identification 
number 4-26 
Pipe 
compose escapes See Mail 
file interchange 7-46 
function 3-12 
lpr command 4-27 
procedure 3-12 
symbol (!) 3-12 
symbol (!) 7-54 
Pipeline 
command list 7-20 
defined 3-12 
defined 7-19 
description 7-7 
DISTINCT 1 shell 
procedure 7-45 
filter 7-7 
grammar 7-52 
notation designated 7-7 
procedure 7-7 
Plus sign (+) 
BC 

addition operator 

symbol 8-4 

unary operator symbol 

8-16 
mail, message 
advancement 6-10 
mail, message 
advancement 6-34 
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variable conditional 
substitution 7-38 
Positional parameter 
description 7-10 
direct access 7-17 
null value assignment 7-38 

number yield, $# 

variable 7-13 

parameter substitution 7- 

11 

positioning 7-10 

prefix ($) 7-11 

setting 7-10 

variable assignment 

statement positioning 7-10 

pr command 4-27 

Print working directory See 

pwd command 
Printing 

command See lpr command 

command See p command 

command See pr command 

ed See Ed 

mail See Mail 
Process identification 

number See PID 
Process 

background See Background 

process 

defined 7-1 

foreground See Foreground 

process 

number See PID 

status 

status 4-26 



Program stopping 2-5 
Prompt character 2-1 
Prompt character 4-1 
ps command 4-24 
ps command 4-26 
PS1 variable 7-12 
PS2 variable 7-13 
pwd command 4-11 
pwd command 4-14 
q command 

ed exit See Ed 
mail 

exit 4-28 
exit 6-17 
exit 6-36 
exit 6-4 
exit 6-9 

message abortion 6-28 
q! See Vi 
Question mark (?) 
directory name, use 
avoidance 7-3 
ed use See Ed 
filename, use 
avoidance 3-4 
mail 

command summary 
printing 6-34 
compose escape 
listing 6-11 
compose escape 
listing 6-2 
compose escape 
listing 6-22 
help command 6-14 
help command 6-3 
metacharacter 7-3 
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metacharacter 7-54 

pattern matching See 

metacharacter 

pattern-matching 

functions 3-8 

single character 

representation 3-8 

variable conditional 

substitution 7-38 
quiet option See Mail 
quit command 

See also q command 

BC exit 8-1 

BC exit 8-3 
QUIT key, background process 

immunity 7-19 
Quit See q command 
Quotation marks, back C % ) 

command line 

substitution 7-8 

command substitution 7-4 

command substitution 7-9 

quoting 7-55 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, double <\0 
Quotation marks, single (") 

filename, use 

avoidance 3-4 

grep command 4-21 

metacharacter escape 7-4 

pattern matching 

cancellation 3-8 

trap command 7-27 



variable substitution 

inhibition 7-11 
Quoting 

backslash (\) use 7-55 

metacharacter escape 7-4 

quotation marks, back (") 

use 7-55 

quotation marks, double 

( 7-55 
r character, read permission 

notation 4-16 
R command See Mail 
r command 

ed use See Ed 

mail use See Mail 
read command 

exit status 7-30 

shell built-in command 7- 

40 

special shell command 7-30 

Read command 

vi See Vi 
Read See r command 
Read-ahead 2-4 
readonly command 

description 7-30 

shell built-in command 7- 

40 

special shell command 7-30 

Record string See Mail 
Redirection 

argument location 7-8 

case command 7-26 

cd arg command 7-30 

control command 7-26 
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diagnostic output 7-6 
file descriptor 7-37 
for command 7-26 
if command 7-26 
input redirection 

procedure 3-12 

symbol (<) 3-12 
minus sign (-) effect 7-36 

output redirection 4-7 
symbol (») 3-11 

pattern matching use 

restriction 7-6 

simple command line, 

appearance 7-19 

special character use 

restriction 7-6 

special shell command* 

restriction 7-29 

symbol (<) 7-54 

symbol ( 
>) 2-3 
>) 7-54 

until command 7-26 

while command 7-26 
Reference Manual 

directory removal 

information 4-13 

linking information 4-10 

sort command 

information 4-21 

stty information 4-4 
Regular expressions See Ed 
Relative pathname See 

Pathname 
Reminder service 

automatic 4-30 



mail 6-32 
Remove directory See rmdir. 

command 
Remove See rm command 
Removing a directory 4-1.3 
Renaming a file 4-8 
Repeat command 

see Vi 5-42 
reply command See Nail 
Report option See Vi 
Reserved word listing 7^55 
Return code See $? 

variable 
RETURN key 

BC 8-2 

command execution 2-2 

command execution 4-4 

command-line buffer 

submittal 3-9 

mail, message display 4-28 

rm command 2*-3 
rm command 4-9 
rmdir command 4-13 
s command 

ed use See Ed 

mail 6-16 

mail 6-17 

mail 6-18 

mail 6-36. 
scale command 8-7 
Scale See BC 
Screen See Scrolling 

screen 
Screen See Terminal screen 
Screen-oriented commands See 

Vi 5-1 a 
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Scripts See Ed 
Scripts See Shell 
Scrolling commands 

more 4-5 
Scrolling screen 

stopping 4-4 
Scrolling, control 4-4 
se command See set command 
Search permission See 

Permission 
Search See Ed 
Search strings 

example designated 3*10 
Searching for a file 4-9 
Searching See / command 
Searching See Vi 
Searching 

vi procedure See Vi 
sed command See Ed 
Semaphore 4-16 
Semicolon (;) 

BC, statement separation 

8-19 

BC, statement separation 

8-3 

case command break 7*22 

case delimiter symbol 7-54 

command list 7-19 

command separation 3*9 

command separator 

symbol 7-54 

ed use See Ed 
set all See Vi 
set command 

mail 

description, Use 6-20 



description, use 6-36 
option control 6-39 

name-value pair 

listing 7^1.6 

positional parameters 

setting 7-10 

shell built-in command 7- 

40 

shell flag setting 7-15 

special shell command 7-30 

sh command 

description 7-1 

mail 6-21 

mail 6-34 

mail 6-36 

shell invocation 7-16 
Shell command 

executing while in vi 5-14 

SHELL string 6-29 
SHELL string 6-40 
Shell 

-e option 7-33 

-k option 7-33 

-n option 7-33 

-t option 7-33 

-u option 7-33 

-v option 7-15 

-X option 7-15 

argument passing 7-17 

command interpretation 3-9 

command 

search procedure 7-2 
special command See 
special command 
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compose escapes See Mail 
conditional capability 7- 
20 
creation 

procedure 7-1 
description 7-1 
echo command 4-20 
entry, mail mode 
source 6-21 
escape 

ed procedure See Ed 

mail procedure See 

Mail 
execution 

flag See option 

sequence 7-18 

termination 7-25 
exit 

-e option 7-33 

-t option 7-33 

mail mode return 6-21 

procedure 7-25 
function 7-1 
grammar 7-52 
in-line input document 
handling 7-36 
interactive 7-39 
interruption procedure 7- 
27 
invocation 

option 7-39 

procedure 7-16 
mail 

invocation 6-6 

shell commands 6-21 
option 

See also Specific 

Option 



designated , use 7-32 

setting 7-15 
pattern matching facility 
See Pattern matching 
facility 

positional parameter See 
Positional parameter 
procedure 

See also Specific Shell 

Procedure 

advantages over C 

programs 7-32 

byte access reduction 

consideration 7-41 

creation 7-31 

description 7-2 

directory 7-32 

efficiency analysis 7- 

40 

efficiency 

awareness 7-40 

examples designated 7- 

43 

filter order 

consideration 7-41 

option See option 

scripts designation 7- 

43 

time command 7-40 

writing strategies 7-39 

redirection ability 7-5 
scripts See procedure 
special command 

See also Specific 

Special Command 

designated 7-29 
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redirection 
restriction 7-29 

special shell variable 7- 

18 

state 7-14 

string See SHELL string 

TERM variable See TERM 

variable 

variable See Variable 
shift command 

argument processing 7-17 

shell built-in command 7- 

40 
si command See Mail 
Simple command See Command 
Single quotation marks See 

Quotation marks, single 

(ii) 

Slash (/) 

absolute pathname 

significance 3-5 

BC, division operator 

symbol 8-4 

command pre pending 

suppression 7-2 

ed use See Ed 

pathname significance 3-5 

search command See Vi 
so command See Mail 
sort command 4-20 
Special character See 

Metacharacter 
Special character 

ed use See Ed 

pattern matching 

facility 7-3 
Special characters 

designated 3-7 



pattern matching 3-6 
Special file 

description 3-2 
Sshared data file 4-16 
Standard error file See 

Output 
Standard error output See 

Error output 
Standard input file See 

Input 
Standard output file See 

Output 
Star (•) 

See also Asterisk (*) 

ed metacharacter See Ed 
Status 

command See ps command 

information procedures 4- 

25 
String option See Mail 
String variable 7-10 
String 

searching for See Search 
stty command 4-4 

terminal setting 2-4 
Subdirectory 4-15 
Subshell, directory 

change 7-1 ^ 
Substitution command See s 

command 
Subtraction See BC 
Subtraction See 

Calculation 
Switch See Option 
Switch 

defined 3-9 

regulations See Option 
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System 

basic concepts 3-1 

characteristics 1-1 

composition 1-1 

mailbox See Mailbox 

tree-structured directory 

system 3-2 
t command 

ed use See Ed 

mail 6-12 

mail 6-16 

mail 6-36 
Table command See Ed 
Tabs 

ed See Ed 
tail command 4-6 
tbl command See Ed 
Temporary file 

directory (/tmp) 4-25 

kill command warning 4-25 

trap command, removal 7-28 

use recommendation 7-13 
term option See Vi 
TERM variable, changing 4-3 
Terminal screen 

output See Output 

scrolling screen See 

Scrolling screen 
Terminal 

changing 4-3 

name designation 2-2 

options setting 4-4 

strange behavior 

remedy 2-4 

writing to See write 

command 



Terminals 

supported 4-3 
terse option See Vi 
test command 

argument 7-35 

brackets ([]) use in lieu 

of 7-33 

description, use 7-33 

operators 7-3** 

options 7-34 

shell built-in command 7- 

40 
Text editor 

ed See Ed 

ex See Ex 

vi See Vi 
TEXTFILE shell 

procedure 7-51 
then clause See if command 
Tilde escape See Mail 
time command 7-40 
Top command See t command 
Toplines option See Mail 
Toplines string See Mail 
Transfer command See t 

command 
trap command 

description, use 7-27 

implementation method 7-29 

multiple traps 7-29 
special shell command 7-30 

temporary file removal 7- 

28 
troff See Ed 
true command 7-36 
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tty, terminal system 

name 2-2 
Type -ahead 2-4 
Type-ahead 4-4 
Typing error correction 2-3 
u command See vi 5-40 
u command 

ed use See Ed 

mail 6-17 

mail 6-36 

mail 6-7 

vi See Vi 
ugo, permission 

classification 4-18 
umask command 

description 7-31 

directory permission 

change 3-2 

shell built-in command 7- 

40 

special shell command 7-31 

Undo command See u command 
Undo command See Vi 
undo command See Vi 5-40 
unset command See Hail 
until command 

continue command 

effect 7-24 

description, use 7-23 

exit status 7-23 

redirection 7-26 

shell built-in command 7- 

40 
User classes 4-17 
User 

addition 2-1 



classification 4-18 
mail See Mail 
mailbox See Mailbox 
permission See Permission 

v command 

ed use See Ed 

mail 6-21 

mail 6-37 

mail 6-7 
Value See $? variable 
Variable 

$! variable 7-14 

$# variable 7-13 

$$ variable 7-13 

$- variable 7-14 

$? variable 7-13 

assignment 

line command 7-9 
string value 7-10 

BC variable See BC 

command environment 

composition 7-15 

conditional 

substitution 7-37 

description 7-9 

double quotation marks 

( 7-11 

enclosure 7-11 

execution sequence 7-10 

expansion 7-4 

export 7-13 

expr command 7-35 

file creation 7-27 

global check 7-33 

HOME See HOME variable 

IFS See IFS variable 
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keyword parameter 7-15 

listing procedure 7-16 

MAIL See MAIL variable 

name defined 7-10 

null value assignment 

procedure 7-37 

PATH See PATH variable 

positional parameter See 

Positional parameter 

prefix ($) 7-11 

PS1 See PS1 variable 

PS2 See PS2 variable 

set variable defined 7-37 

special variable 7-13 

string value 

assignment 7-10 

substitution 

-u option effect 7-33 

double quotation marks 

( 7-11 

notation 7-54 

redirection 

argument 7-6 

single quotation marks 

(*') 7-11 

space 

interpretation 7-11 
test command 7-33 
types designated 7-12 
Vertical bar (J) 
mail escape 6-25 
or-if operator symbol 
(!i) 7-19 
pipe symbol 3-12 
pipeline notation 7-7 
Vi, mail 
compose escape, v 6-38 



Vi 



editing 6-21 

entry from command 

mode 6-7 

entry from compose 

mode 6-7 

VISUAL string 6-40 

• command See dot (.) 
command 

• command 

See dot (•) command 
.exrc file 5-54 
.login file 

terminal type setting 

use 5-50 
.profile file 

terminal type 

setting 5-50 
/ command 

searching 5-9 
command 

cursor movement 5-5 
:q! 5-16 
:x 5-16 

:x command 5-42 
appending text 

A 5-21 

See also inserting 

text 
args command 5-45 
b command, cursor 
movement 5-5 
breaking lines 5-26 
buffers 

delete 5-33 

delete See delete 

buffer 
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naming 5-23 

selecting 5-23 
C command 5-30 
C shell 

prompt 5-50 

TERM variable 5-50 

terminal type 

setting 5-50 
canceling changes 5-43 
caret (*)., pattern 
matching 5-39 
caret (*)., pattern 
matching 5-40 
cc command 5-31 
CNTRL-B 

scrolling 5-5 
CNTRL-D 

scrolling 5-5 

sub shell exit 5-48 
CNTRL-F 

scrolling 5-5 
CNTRL-G 

file status 

information 5-11 

file status 

information 5-47 
CNTRL-J, inserting 5-26 
CNTRL-L 

screen redraw 5-48 
CNTRL-Q, inserting 5-26 
CNTRL-S, inserting 5-26 
CNTRL-U 

deleting an 

insertion 5-28 

scrolling 5-5 
CNTRL-V, use 5-26 
co (copy) command 5-24 



colon (:) 

line-oriented command, 

use 5-12 

status line prompt 5-12 

command mode 
cursor movement 5-5 
entering 5-3 

command 
line-oriented See line- 
oriented commands 5-12 

repeating, dot (.) 

use 5-6 

screen-oriented See 

screen-oriented 

commands 5-12 
control characters, 
inserting 5-26 
copying lines 5-24 
correcting mistakes 5-21 
crash, recovery 5-48 
current line 

deleting 5-28 

deleting 5-6 

designated 5-2 

line containing 

cursor 5-4 

number, finding out 5- 

24 
cursor movement 

$ key 5-19 

+ key 5-19 

b 5-18 

backward 5-19 

BKSP 5-17 

by character 5-17 
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by lines 5-19 

by words 5-18 

CNTRL-N 5-19 

CNTRL-P 5-19 

down 5-17 

down 5-5 

e 5-18 

F 5-17 

forward 5-19 

h 5-17 

H 5-19 

i 5-17 

j 5-19 

k 5-17 

k 5-19 

keys 5-5 

1 5-17 

L 5-19 

left 5-17 

left 5-18 

left 5-5 

line beginning 5-5 

line end 5-5 

LINEFEED key 5-19 

lower left screen 5-5 

M 5-19 

RETURN key 5-19 

right 5-17 

right 5-18 

right 5-5 

screen 5-19 

scrolling See 

scrolling 5-5 

See also scrolling 

SPACEBAR 5-17 

T 5-18 

to end of file 5-5 



up 5-17 

up 5-5 

upper left screen 5-5 

w 5-18 

word backward 5-5 

word forward 5-5 
cursor movment 

right 5-17 
cw command 5-30 
D command 5-6 
d$ command 5-6 
dO command 5-6 
date, finding out 5-14 
dd command 5-6 
delete buffer 

use 5-33 
deleting text 

by character 5-27 

by line 5-27 

by word 5-27 

D 5-27 

dd command 5-27 

deleting an 

insertion 5-28 

dw command 5-27 

methods 5-6 

repeating deletion 5-^2 

undoing 5-^0 

undoing deletion 5-*» 

X command 5-27 
demonstration 5-1 
description 5-1 
dollar sign ($) 

cursor movement 5-5 

pattern matching 5-39 
dollar sign($) 

use in line address 5- 
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28 
dot (.)cotnmand See • 
command 5-6 
dot See also dot (•) 
command 

dot, use in line 
address 5-28 
dw command 5-6 
editing several files 

changing the order 5-45 

end-of-line 

displaying 5-51 
entering 

at a specified line 5- 

17 

at a specified word 5- 

17 

procedure 5-2 

with filename 5-16 

with several 

filenames 5-43 
error messages 

shortening 5-52 

turning off 5-46 
ESCAPE, insert mode 
exit 5-3 

ESCAPE, insert mode 
exit 5-48 
exclamation point (!) 

shell escape 5-14 
exiting 

:q! 5-16 

:x 5-16 

:x command 5-42 

saving changes 5-42 

saving file 5-13 



temporarily 5-14 

temporarily 5-46 

without saving 

changes 5-43 

11 command 5-43 
file 

creating 5-2 

not saving, sq! 5-16 

saving 5-16 

status information 

display 5-10 

status information 

procedure 5-11 
filename 

finding out 5-47 

planning 5-44 
G command 

cursor movement 5-5 
goto command See G 
command 
H command 

cursor movement 5-5 
i command 

inserting text 5-2 
ignorecase option 5-36 
ignorecase option 5-51 
insert command See i 
command 
insert mode 

entering 5-3 

exiting 5-3 
inserting text from 
another file 5-14 
inserting text 

See also appending 

text 

control characters 5-26 
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from other files 5-22 

i 5-21 

repeating insert 5-22 

repeating insert 5-42 

undoing 5-40 

undoing insert 5-48 

undoing insertion 5-4 
invoking See entering 
j command 

cursor movement 5-5 
joining lines 5-26 
k command 

cursor movement 5-5 
L command 

cursor movement 5-5 
leaving See exiting 
line addressing 

dollar sign 5-28 

dot(.) 5-28 

procedure 5-28 
line numbers, displaying 

:nu command 5-48 

linenumber option 5-15 

linenumber option 5-24 

linenumber option 5-52 

nu command 5-24 
line-oriented command 
mode 5-47 
line-oriented commands 

:args 5-45 

:e 5-23 

:e 5-45 

:e# 5-23 

:e# 5-46 

:f 5-47 

:file 5-47 

:n 5-44 



:nu 5-24 

:nu 5-48 

:q 5-43 

:r 5-22 

:rew 5-45 

:s 5-31 

:w 5-22 

:wq 5-42 

colon (:) use 5-12 

deleting text 5-27 

entering 5-12 

moving text 5-31 

status line, 

display 5-10 
linenumber option 5-52 
list option 5-51 
magic option 5-40 
magic option 5-53 
marking lines 5-23 
mesg option 5-53 
mistakes, correcting 5-21 
mode, determining 5-48 
mode 

See also command mode 

See also insert mode 

See also line-oriented 

command mode 
moving text 5-31 
n command 5-10 
n command 5-36 
new line, opening 5-22 
next command 5-44 
opening a new line 5-22 
options 

displaying 5-51 

ignorecase 5-36 
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ignorecase 5-51 

linenumber 5-24 

linen umber 5-31 

linenumber 5-52 

list 5-15 

list 5-51 

magic 5-40 

magic 5-53 

mesg 5-53 

report 5-52 

setting 5-49 

setting 5-51 

term 5-52 

terse 5-52 

warn 5-46 

warn 5-53 

wr apse an 5-36 

wr apse an 5-53 
over strike commands 5-28 
pattern matching 

See also searching 

beginning of line 5-39 

caret (~) 5-40 

character range 5-39 

character, single 5-39 

end of line 5-39 

exceptions 5-40 

generally 5-39 

special characters 5-40 

square brackets 

(C3) 5-39 
per iod ( . ) 

pattern matching 5-39 

repeat command 

symbol 5-3 
problem solving 5-48 



putting 5-23 
Q command, line-oriented 
command mode 5-47 
quitting See exiting 5-43 
r comand 5-14 
r command 5-28 
read command 5-14 
redrawing the screen 5-48 
repeat command 5-42 
repeating a command 5-42 
replacing a line 5-30 
replacing a line 5-31 
replacing a word 5-30 
replacing a word 5-31 
report option 5-52 
rew command 5-45 
S command 5-29 
s command 5-30 
saving a file 5-43 
screen, redrawing 5-48 
screen -oriented 
commands 5-12 
scrolling 

backward 5-5 

down 5-20 

down 5-5 

forward 5-5 

up 5-20 

up 5-5 
searching and replacing 

a word 5-37 

c option 5-38 

choosing 

replacement 5-38 

command syntax 5-37 

p option 5-38 

printing 

replacement 5-38 



1-56 



searching See / command 
searching 

See also searching and 

replacing 

backward 5-35 

caret (*) use 5-39 

caret 5-39 

caret O 5-40 

case signficance 5-51 

case significance 5-36 

dollar sign ($) 5-39 

forward 5-10 

forward 5-35 

next command 5-36 

period (.) 5-39 

procedure 5-9 

repetition 5-10 

special characters 5-36 

special characters 5-53 

square brackets 

([]) 5-39 

status line, 

display 5-10 

wrap 5-10 

wrap 5-36 

wrap 5-53 
session, canceling 5-16 
set all, option list 5-15 
set command 5-49 
set command 5-51 
setting options 5-51 
shell command, 
executing 5-14 
shell escape 5-46 
slash (/) 

search command 



delimiter 5-9 
special characters 

matching 5-40 

searching for 5-36 

searching for 5-53 

vi filenames 5-44 
status line 

line-oriented command 

entry 5-12 

location 5-10 

prompt , colon ( : ) 

use 5-12 
string 

pattern matching 5-39 

searching for See 

searching 
sub shell 

exiting 5-48 
Substitute commands 5-29 
switching files 5-45 
system crash 

file recovery 5-49 
tabs 

displaying 5-51 
TERM variable 5-50 

Bourne shell 5-50 

Visual Shell 5-50 
termcap 5-50 
terminal type setting 

Bourne shell 5-50 

C shell 5-50 

how 5-52 

Visual Shell 5-50 
terse option 5-52 
time, finding out 5-14 
u command 5-4 
u command 5-40 
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u command 5-48 

undo command See u 

command 

undoing a command 5-40 

w command, cursor 

movement 5-5 

warn option 5-46 

warn option 5-53 

warnings, turning off 5-53 

word, deleting 5-6 

wrapscan option 5-36 

wrapscan option 5-53 

write messages 5-53 

writing out a file 
:wq command 5-42 
:wq command 5-43 

x command 5-6 

yanking lines 5-23 

yanking lines 5-26 

ZZ command 5-43 
visual command See Mail 
Visual Shell 

TERM variable 5-50 

terminal type 5-50 
VISUAL string See Mail 
w character 

directory permission 

notation 4-16 

file permission, write 

notation 4-16 
w command See Vi 
w command 

ed use See Ed 

mail 

message saving 6-18 
message write out 6-37 



system mailbox , message 

deletion 6-17 
wait command 

description 7-31 

exit status 7-31 

shell built-in command 7- 

40 

special shell command 7-31 

warn option See Vi 
wc command 4-22 

word count 3-13 
while command 

break command effect 7-24 

continue command 

effect 7-24 

description, use 7-22 

exit status 7-23 

loop 7-44 

redirection 7-26 

shell built-in command 7- 

40 

test command 7-33 
who command 4-25 

description 2-2 

logged in users list 3-13 
Word 

counting See wc command 

grammar 7-52 
Working directory See 

Current directory 
wrapscan option See Vi 
wrapscan option See Vi 5-36 
write command 4-28 
Write out See w command 
WRITEMAIL shell 

procedure 7-51 
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x character 
directory permission 
search 4-16 

file permission, execute 
notation 4-16 
x command See Vi 
x command 
mail 

exit 6-18 
exit 6-34 

session abortion 6-11 
vi use See Vi 
z 

vi scroll 5-20 
ZZ command See Vi 5-43 
[] See Brackets ([]) 
{} command See Braces 

command ( { } ) 
bcc escape See Mail 
cc escape See Mail 
dead escape See Mail 
editor escape See Mail 
headers escape See Mail 
message escape See Mail 
print escape See Mail 
quit escape See Mail 
read escape See Mail 
subject escape See Mail 
to escape See Mail 
visual escape See Mail 
write escape See Mail 
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